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Want to unlock the power 
of PowerPC microprocessors? 

Here’s the key 



If you want to crank out code that really 
screams an PowerPC microprocessor* 
based systems, then it helps to work with 
the experts who know the PowerPC 
Architecture 01 inside and out” Motorola. 

Motorola's Software Development Kits 
fur Power Macintosh™ leverage our experi¬ 
ence as one of the creators of the PowerPC 
Architecture. Wc know how to get the 
highest possible performance out of every 


member of the PowerPC' family, including 
the PowerPC 603™ and PowerPC 004™ 
microprocessors. And wc hut Id that exper¬ 
tise into our highly optimizing C/C++ and 
FORTRAN compilers. TheyII streamline 
your code* so your applications run cleaner 
and faster. Ami that can give them the edge 
in the marketplace, 

And now* when you license a Motorola 
C7C++ or FORTRAN SDK for only $349; 


you’ll gel the complete Apple® MPW environ 
menu as well as free upgrades for a full year. 

So contact Motorola for more informa¬ 
tion, or to order your own Macintosh® SDK, 
And unlock the power iaside PowerPC 
litkroprocessors. 

Call 1*800-347-8384 or 1-512-8914999. 
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Eddy Award Winner for Best New Developer Ttml 

- Mac User Editors Choice Aw ards, 1993 

M A distinct improvement over ResEdiL 9 

- MacTech / MacTulor 

“Resorcerer s data template system is amazing!" 

- Bill Goodman, author of Compact Pro 

"Nuke Res Edit! Re sorcerer is mission-critical for us. M 

- Dave Winer, Userin nd Frontier 

*The color pixel editors are wonderful! A work of art! 

- Dave Winzler, author of Microseeds Redux 


‘Every Macintosh developer should own a copy of Resorverer . w 

- I canard Rosenthal, Aladdin Systems 

"Resorcerer will pay for itself many times over in saved time and effort . 
Mad her review 

“The template that disassembles i PICT t s is awesome} 

- Bill Steinberg, author of Pyro! and PBTools 

"Resorcerer proved indispensable in its own creation!' 

- Doug McKenna , author of Resorcerer 

*-a wealth of time-saving tools. 9 

MaeUeer Review, Dec , 1992 




Version 1.2.4 


The Resource Editor for the Macintosh Wizard 


ORDERING INFO 


Needs: >Mac Plus, > Sys 4.2, 1MB 
Likes: -Mm* Plus, S Sys 7.0, 2MB 
32-hit clean, AU/X compatible 

Price: $256 (decimal) 
(Educational, quantity, or 
other discounts available! 

hidudes: 500 page manual 
60-day Money-Back Guarantee 
Domestic UPS ground shipping 

Payment: Check, POX or Visa/MC 

Extras (call us): 

COD. FedEx, UPS Blue/Red, 
international Shipping 


Downloadable Dcmos/Updaters: 

AppleLink: Software Sampler 
AOL: Software Lihs^Development 
CompuServe: MACDEV/Tbols 
or call us. 


* New* 4 cicn\ ‘ppat\ *cr*r\ ‘npur 1 , 4 clirt* editors 

* Powerful icon family editing (all 9 icon types! 

* Color pixel anti-aliasing, dithering, and lots more 

* Complete ‘PICT* disassembly and reassembly 
New 1,2 Features: ■ Resource sorting; ROM resource browsing 

* 120 template field parsing types now supported 

* New' insertion & deletion te in plate field types 

* Text-only ‘PICT’ resources 

* 1 aits of improvements throughout 

• Easier, faster, more Mac-like, and more productive than Res Edit 

• Safer memory-based, not diskfilc-hased, design and opera!ion 

• All file information and common commands in one easy-to-use window 

• Compares resource files, and even edits your data forks as well 

• Visible, accumulai ing, editable scrap 

• Searches and opens/marks/selects resources by text content 

• Makes global resource ID or type changes easily and safely 

• Builds resource Hies from simple Rez-like scripts 

• Most editors DeKez directly to the clipboard 

•All graphic editors support screen-copying or partial screen-copying 

• Hot-linking Value Converter for editing 32 bits in a dozen formats 

• Its own 32-bit List Mgr can open and edit very large data structures 

• Templates can pre- and post-process any arbitrary data structure 

• Includes nearly 200 templates for common system resources 

• TMPLs for Installer, MacApp, QT, Help, Ap pi ©Event, OCE, OX, etc. 

• Full integrated support for editing color dialogs and menus 

• Try out balloons, ‘ictbs, lists and pop ups, even create C source code 

• Integrated single-window Hex/Code Editor, with patching, searching 

• Editors for cursors, versions, pictures, bundles, and lots more 

• Well-designed, helpful developer tools being added all the time 

• Relied on by thousands of Macintosh developers around the world 


MATHEMjESTHETICS, INC. 
no. Boy 298 • Boulder * CO • 80306-0298 * USA 
Phone: (303) 440-0707 • Fax: (303) 440-0504 
AppleLink/AmericaOnline: RE SORCERER ■ Internet: resorccrer@aol.com 
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By Scott TBoyd, lulitor-at-Uirge, http://wuw.bax.com/ 


Out of circulation for some lime now; all of u sudden TMON 
has reappeared on the scene Rumors have circulated since 
before WWDC this year dial TMON would make ils 
ree mergence. only to listen lo deafening silence. Well, silent no 
more, TMONs bfickl Check out htlp://www.tmon,com 

TMON last saw major work for System 7 compatibility. 
Since then il has had something of a humpy ride. For example, 
Waldemar Horwau its author, spent a little time finishing up his 
Ph.D. at MIT. ICOM Simulations, the original publisher, was 
purchased by Viacom. As you might imagine, the media giant 
was a little less interested in a debugger, no matter tiow great, 
than in l COM's multimedia e\|xrrtise. 

My interest in TMON goes I Kick to 1985. 1 was in grad 
school at Texas A&M, discovering how difficult grad school can 
Ik* when there's this really ox>l computer called Macintosh that 
I could spend every waking hour learning to program. Hipping 
through Mncazinc (anyone remember that great rag?) 1 came 
across a briel mention of CompUTopia, a Macintosh conference 
in Austin. 1 hnpjx-d in the car and drove to Austin. 

One hanqiict-hall-slzed room had booths all the way 
around, probably not more than twenty or so altogether. Just 
inside the entrance was a giant, inflatable Macintosh. I w'as 
having a blast hanging out with Fellow Mac enthusiasts when 1 
noticed a crowd of especially geeky types gathering around one 
machine. Home extremely-animated guy was driving the 
machine while somehow waving his arms around, too, 

I went over and stared at the screen. "What on earth has 
lie done to itT The windows were all as wide as the monitor, 
anti they only moved vertically* and the contents moved live 
They didn't use rite standard WDEP, either. -What’s all that 
monospaced gunk in those windows' Wait a minute! I think 
I'm starting to understand." It gradually came into focus - I was 
staring at a debugger, unlike anything I had ever seen. 

Soon after that 1 purchased my first copy of TMON, and it's 
served as my debugger of choke ever since, it was a great 
favorite among Blue Meanies during 7.(1 development, too 

One til the great moments in debugging history was the 
moment when 1 asked the first PowerPC 6HK emulator engineer 
whether TMON would work with his emulator I don’t know 
whether to describe the kx>k on his face as surprise or fear. It 
certainly belled his confident retort of *YesT Shortly thereafter I 
tried it <hki on one of the very first PDMk (which later became 
the 6100) Stile enough, it worked fine. It’s a mighty odd sight 
to see a low-level debugger, confident as ever that iris 
displaying the detailed slate of a 6KK chip when there's not 
really one inside the lx>x... 

Now TMON knows about lx*th chips. Most of the tricks it’s 
always known now work for the PowerPC, loo - interactive 
assembly (just type il in) and disassembly; live displays oj 
processor state, raw memory dumps, low memory (with 
names), and structure templates; and breakpoints and stepping. 


TMON also knows some new tricks. For example, it 
indicates which direction of a branch you’ll take (just like 
Macsbug has done for a long time). TMON also handles CFM 
fragments TMON also offers filters on heap windows, so now 
you can III nil the blocks displayed by attribute and/or resource 
info. And here's my favorite feature - stepping no longer does 
a screen swap unless it needs to. 

Now, back to the history lesson. 1 spent some time It yoking 
carefully ai picking up the product right after Viacom purchased 
[COM 1 deckled to pass, but Allan Foster of Guru, Inc. got 
interested After working out an arrangement with Viacom and 
Waldemar, Guru look it on. He did a huge chunk of work on 
it. adding most of the features mentioned above just about the 
lime it was ready to ship, MindVision approached him with an 
offer he couldn’t refuse, and now TOON is shipping under the 
MindVision label. 

Now. no mention of debugging would he complete 
without mentioning two other sialwarts - Macsbug and Jasik 
Apple’s Jim Murphy has recently added a slew of PowerPC 
support items to Macsbug (too many to go into now ), and it’s 
definitely worth checking out. It's available in the usual places. 

Likewise, Jasik has added some interesting items 
(http://www.jasik.corn). Nosy now disassembles 1*EF containers, 
and has a fancy new resource selection dialog. The Debugger 
handles PowerPC-native watch points, and can read in the 
symbolic debugging info files created by Nosy s PFF disassembly. 

Debuggers for the Rest of Us 

I'm excited to see the return of TMON. Macintosh developers 
deserve to have all the excellent tools they can geL and 
professionals should have them all. By and large, they all 
provide far more value than they cost. In addition, the 
longevity and expertise represented by folks like Jasik and 
MindVision brings a lot more to the table dun just a piece of 
debugging software. I know of one developer who liought 
Jasik s Debugger just so he could call Steve with an occasional 
question. U s great to see all three debuggers undergoing active 
develt ipment aml sup[x nt ! 

Food For Thought 

In answer to the question, “What s the ctxilcsl stulT arming out 
of Apple lately?" I expected In hear about PCI machines (they’re 
Iasi), the Color LaserWriter (looks gtxxJ, gcxxJ price), or QTVR 
(too cool!). I got the folk wing answer; “Engineers,'’ Ouch! 

“A new tool for every project S’ 1 - Cktnion Sheridan 

Internet. Mention it and inaylx 1 your stock price will climb to 
SI tO/share, too! I mentioned it. Maybe it’s time for an 
acquisition,,, ^ 


VitWEOivr 
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Each year, the illegal use of software 
consumes nearly S0^» of your potential 
revenues, With the flames of piracy eating 
away at your profits, can you afford not to 
protect your software? 


Software Obtained It legally, by region, 1993 vs. 1994 
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MacHASP" 1 ' is widely acclaimed as the world's 
most advanced software protection solution 
for Macintosh computers. Since lf}84 t 
thousands of leading Mac and PC developers 
have used over one million MacHASP and 
i IASI 5 keys to protect billions of dollars worth 
of software. Why? Because Mad I/VSR's 
security, reliability and ease-of-usu Id them 
to a simple conclusion: MacHASP is die most 
effective software protection system available 



Today more develoj^rs are choosing 
MacHASP than any other software protection 
method. To learn why and to see how easily 
you can increase your revenues* call now to 
order your MacHASP Developers Kit. 

1 - 800 - 223-4277 


ALADDIN 


The Professional's Choice 
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Building Internet And Other Native PowerPC 
Applications Has Never Been Easier Or Faster. 


SmalltalkAgents® 

SmalltalkAgents (STA) Ls a 
sophisticated rapid applica¬ 
tion development environ¬ 
ment I rased on a new gen¬ 
eration of the Smalltalk lan¬ 
guage, enabling yon to easily deliver double- 
dickablc applicatloas. 



Imam 

MACINTOSH 


Copland Style GUI Look & Feel 



design and project elements in a "finder- 
like" desktop workspaces fluidly as you 
work with folders and documents on your 
desktop, interactively build, wine, and inter¬ 
connect reusable components and inter¬ 
faces in an integrated environment. 

GUI Design & Generation 

live “Drag and Drop” manipulation to build 
your application's visual interface using 
components that "know" how to behave 
and auioconligurc themselves into an envi¬ 
ronment. Create new components and/or 
wine together existing components that am 



be saved as reusable template designs for 
use in other applications or containers. 


Creating professional quality user interfaces 
is easy with our cunijxinem parts libraries. 

VisualWorkbench 

Visually manipulate all objects including 
source and design elements using your 
mouse anil keyhexird, Visually manage 



DTP Engine & Word Processor 

STA nm only includes a programmable 
word processor component and 
Hyjxa'Malia engine, but also a powerful 
rqx irt writer that supports embedding of 
any kind of objects, movies, flows, and 
international tod. and [xige layout. 

C/C++, Pascal Workbench 

Ganpile. edit, and dynamically link QC++, 
Pascal. Fortran, amt Assembly code directly 
from within our STA Visual Vw irkbeneh as an 
integrated pan of the Smalltalk application 
development process. 

Component-based Architecture 

STA components arc designed lor Open! )oc 


and OLE. and will give you transparent inte¬ 
gration with OpenDoc and OLE when they 
become available. 

Threading A Internet Tools 

STA provides powerful support for Internet 



server as well as diem tool development. 
Pre-emptive threading, thread safe libraries 
and classes for TCP/IP protocols are stan¬ 
dard features enabling you to quickly and 
easily deliver custom e-mail, WW, list-serv¬ 
er. and other dial-up/nenviirk related apps. 


PowerPC Support 

STA provides binary portability across differ¬ 



ent < IP! Is anil Operating Systems. Design 
applications tot lay on one platform ml situ 
ply deploy on other platforms as required. 


Contatl us about our Web Server & 
Client Uiolkii at I-800-296-13.W or at 
<info(o qks.com> or visit our Vieh sire 
hit p:,/wwvv.qks.com . 



Quasar Knowledge Systems 1 Inc. 

9(018 Parkwpod Drive 

Belhesda, MD 2(1814 USA 

Tel: (3011530-4053 Fax: (301J 530-5712 


15 Quasar Kncwladfln SyrtTmtiti, Inc: 1995 Ail rtgltla reserved All oilier brand ar product names are trademarks or mastered trademarks ol thek respective holders 










































































































GETTING 

STARTED 


By Dave Mark. MacTech Magazine Regular Contributing Author 




PowerPlant and Modeless Child Windows 


In last month's column, we bulk an 
application that featured windows with 
two push buttons and a scrolling picture 
pane. The first button beeped when 
you clicked it. The second button was 
disabled This month, well extend the 
PictScToUer program. We'll enable the 
second button so that when you dick it. 
a new window appears, allowing you to 
select a new picture for the scrolling 
picture pane. 

Thanks once again to Greg Dow far 
all his PowerPlant help. Greg is a real 
friend to this column and has never been 
too busy to lend a hand. 

Copy Last Month’s 
PictScroller Project 

Start off by making a copy of last 
month's project folder. Rename it 
Pi ctScroller2 or something like that. 
This way, if things get a little screwy, 
you d< m’t have to start over from scratch. 
Ar the very least, you'll be able to start 
from where we left off last month. 

Once your old folder is tucked safely 
away, open up the Piet Scroller 2 
folder. Our first step will he to add two 
more PICT resources to the Constructor 
file Pic t Sc roller * rsrc* 

• Open up PictScroller.rsrc 
using your favorite resource editor. 

■ Change the resource ID of the existing 
PICT resource from 128 to 2001 

• Add two more PICT resources to the 
file and change their resource IDs to 
2002 and 2003 

• Save your changes and quit your 
resource editor. 


In addition ro the sun PICT from last month’s column, I 
added the moon and red car pictures from my Scrapbook. 

Our next step is to edit PictScro 1 ler. rsrc using 
Coastructor, 

* I)ouble-cik:k on the file Piet Scrol1e r * r s rc. 

Constructor will open the file Pie tScroller * rsrc and 
display a window listing all the views in this file. At this point, 
we've got a single view, an LWindow with an id of 1 and ihe 
name PietWindow. Our first goal is to make a few changes to 
our ousting LWindow view. Our second goal is to create a new 
view, an LWindow with 3 radio buttons and a mini PICT frame. 
Let's start by editing the existing LWindow. 

* Double-dick on the LWindow with the id of 1 (it should be 
the only view listed in the master view list). 

The view editing window for the PicLSt roller LWindow will 
appear. 

* Double-click on die titlebar of the window embedded in the 
view editing window (the title bar says Pic tScroller), 

An info window for the PictScroller window will appear. 
This next step is incredibly important: 

* Change the Class ID field from wind to CpsW, 

* Close the PictScroller info window* 

The four letter (case sensitive!) code tells PowerPlant what 
type of object we are creating. The code 'wind 1 corresponds to 
the dass LWindow. That’s the class w f e used last month* This 
month, we’ll be subclassing LWi ndow with a class named 
CPictScrollerWindow. When you enter the 
CPlctScrollerWindow class definition (later in Lhe column), 
you'll see lhat we create an enum constant with the name 
class_ID and die value 1 CpsWV Each time you create a class 
that implements a PowerPlant view, you'll enter the class' 
class_lD code in the Class ID field in the view's info window. 
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* Double-click on Ihe LPictUre pane (it has a pane id of 1003). 

* When the pane info window appears, change the PICT 
Resource JD to 2001 

The first of your thrt:c PICT resources (the one with the 
resource ID 200 i) should now lx* displayed in the scrolling pane. 

* Close the LPicture pane info window. 

* Double-click the Dialog button (the right button). 

■ Click on the Enabled check box (so that it is checked). 

* Change the Ualue Message to 1001 

* Change the Button Title to Picture... 

* Close the button's pane info window. 

The button will now say Picture... and will no longer he 
disabled. Also, when it is clicked in your application, it will 
broadcast a message with a value of 1001 to any listeners. 

Now' let’s add a new view. 

* Close the view editing window for the Piet Window LWindow. 

■ Select New Resource from the Edit menu. 

* When the view naming dialog appears, make sure 
LlLMndoui is selected from the popup menu, type 1 Piet 
Selector (Child) in the edit field, and dick the OK button. 

A new- view editing window will appear Before we add 
any items to the new view, change the view s ID to 2000 

* Close the view editing window, 

* Select L Window 128 in the master view* list, then select 

Resource Info from the Edit menu. 

* Change the Resource ID from 12H to 2000. 

* Close the resource info window, 

* Double-click on the Piet Selector view in the master view list. 

A view editing window for View 2000 will appear. 

Note: Grog Dow uses a numbering convention that ill try to stick 
to from now on. Me numbers all his new views by thousands. 
So his views have IDs like 1000, 2000, 3000, etc. The items 
within a view start at one plus the view OX That means that the 
items in this new view will Ixr numbered 2001, 2002. 2003, etc. If 
you have groups of items (like radio buttons, for example), you 
might want to leave holes in your numbering scheme, for 
example, you might number your radio buttons 2001, 2002. and 
2003, then start the next set of items with 2010, 2011* 2012. As 
always, pick a scheme you like and try to lx consistent. 

* Double click on the window inside the view editing 
window. 

* When the into w indow appears, change its settings to match 
those shown in Figure L 

* Close the info window. 



higure L The info window for the Picture Selector window. 


Next, youll create the four items that make up this new 
view': three radio buttons and a mini-picture frame. 

* Drag an LSidRadioButton from the palette window onto the 
Picture Selector window, 

* Double-dick the new radio button, 

* When the info window appears, change its settings to march 
those shown in Figure 2. 

* Close the info window, 



Figure J. 7 he info window for the Sun radio button. 

* Drag a second LStdRadioButton from the palette window 
onto the Picture Selector window, 

* Double-dick the new radio button. 

* When the info window appears, change its .settings to match 
those shown in Figure J, 

* Close the info window. 
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Announcing 

MICOEUARD^ 


Why so many developers are switching to 
MicroGuard copy protection 


• MicroGuard is committed to uncompromising 
technological superiority 


• MicroGuard has now surpassed its own 

technological lead, actually improving on the best 



Ttihruikigy at Us peak" b nur commitment loyou, Tfoi is why we hwr 
hnrnght vou MkroGuarti Plus™ And MirruCiianl Hus is 100% 
backwards compatible wnh MrmCiuafd. Hus means MtottGuanl 
and MrroGutmS f\us can he tsed mtefikmgcahh 
Just i> WL- jumnscil! 


MicroGuard offers you the 
most sophisticated network 
protection 

OurfWttWirk pmiMMjn, MicroGtiard Net IM , 
is stj sujxfinr, wc hart to hirr an Apple network 
engineer to mime (wrspcdfKaikm. 


MicroGuard is the only key 
developed hv Mac 
developers, and is the first 
anil only 100% ADB savvy key 


MiCfuGuani Hus is everything Shot >G lord t\ plu^ 4Wiil encryption^ iwu 
aildiltunal passwtxds, 644hi Array, 32-hyu* publ* area. wv reduction, 
cuiunced counterami more fn idditkm, MimiOuanJ Plus < >fFas mi> new 
utilities QufrkGuard “ amt HasvGumP ilk iw you to protect your 

mi wul mm tuwlung \\w 
source aide live unh feature that 
b not plus is ihe price : ) 


• MicroGuard is the best 
selling Macintosh key in 
the world 

MkroGuaitl sells more Macintosh 
cv if>v-pn *rrtn m keys than amt me dsc 
m the wt*kl! 


• MicroGuard delivers 
developer support 
within l\ hours 


We have hern developing Mar applications as j .seed ttodopnient house 
.since \%\ Wc arc not a PC prureniun company that has come to \m 
with a Mat product MicroGuard b fully ADB wvy ami ofTrfs extended 
addressing. Unlike other protection drvirts, MirmGuard never dasho 
with other keys. Only MkinGtiard oilers lilts IcvtH ctf sophistical* m 


We will answer arty injury yi mi have within 21 hi Kirs Wc also tuivc a fullv loaded 
Appldink hulkttn htwitl which contains all our lihnincs, lech nous, Q&A and 
nearly cvvniltmg wull ever need" 



For more information and to order a DetvlofjeCs Kit or to receipt a free CD ROM afamt MicroOuard, 
please contact ns at 


Mil roCuuml USA: Tel: (303) 320-1628 • Fax: (303) 320-1599 • AppleUnk; M.GUARD 

International: Tel: (972) 3 55H-2345 • Fax: (972) 3 558-23*1 1 * Appleljnk: MICROGUARD 
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Figure 3 The info window for the Moon radio button, 

* Drag a third LStdRadioButton from the palette window onto 
the Picture Selector window. 

* Double-click the new radio button* 

* When the info window appears, change iLs .settings to matc h 
those shown in Figure 4, 

* Close the info window. 



Figure i The info window for the Red car radio button , 

As is, these three radio buttons will act independently. 
That is, if you dick on one to turn it on or off, it will have no 
effect on die others. To fix this problem, we need to group the 
three buttons into a radio button group. 

* Mold down the shift key and select all three of the radio 
buttons. 

* Select Make Radio Group from the Arrange menu. 

Next, well create the mini-picture frame. 

* Drag an LPicture from the palette window onto the Picture 
Selector window. 

* Double-click the new LPicture pane. 

* When the info window appears, change iLs settings to match 
those shown in Figure 5, 


* Close the info window 

* Quit Constructor, Be sure to save your changes. 



Figure 5 the info window far the LPicture m in-j nature frame. 


That's about it for your Constructor session* Figure 6 
shows my finished Piet Selector view'. Notice that none of the 
radio buttons is turned on and that the mini-picture frame is 
just a grey square. Well set up the buttons and display the 
right picture in our source code, whic h we 11 get to next. 



Figure 6 Ihe finished Piet Selector view 

Entering the Source Code 

Well modify two source c ink* files and add two new source code 
files. Well start with some changes to Piet Sc roller, cp, 

• Open the project file PictScrol ler 

• Open the file FictScroller. cp, 

• Add the line; 

finclude "CPictScroileriindov,h* 

immediately after the //include of Piet Sc roller, h, 

CFictScrollsrWindrjw-h contains a brand new class 
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N ow, through a joint 
development agree¬ 
ment* Symantec and 
Apple 1 * Computer let you 
produce the fastest Power 
Mac code, 

Symantec C++- lor 
PowerMacintosh 1 " now 
comes with MrC— Apples 
new optimizing compiler. 

Industry-standard 
NuIIstonc rests show that 



size and color. Organizing 
and navigating a project 
has never been easier. 

In addition* Symantec 
C++s multi-threaded envi¬ 
ronment gives you the abili¬ 
ty to edit and write code 
while you compile. And 
our visual architect lets you 
quickly draw the interface* 
Corresponding code is then 
generated automatically. 


when MrC Goes to work, 
Symantec C++ applications Get 22% faster. 


applications compiled with MrC 
run an average of 22% faster, 

DEVELOP FASTER 

Applications faster. 

Not only can you develop the 
fastest Power Mac applications, 
you can write them fast, too. 
New AppleScript support lets you 
automate repetitive tasks. While 
the new linker provides fast turn¬ 
around for incremental builds. 

With the fully integrated 
class browser, you'll quickly nav¬ 
igate your C++ class library. 
And support for templates and 
mulriple inheritance further 
boosts your productivity. 

Organize And Manage 
projects easily. 

The new Project Manager 


lets you organize and manage 
nested projects. You can 
display hierarchical 
groups as folders within a 
project window for easier 
organization. 

The editor gives you 
unlimited split panes and 
full text formatting- font* 

MrC Compiler 

pmdurei thejmtest Power Mar applirattnm 

AppleScript 

autumam the build proant 

New Incremental Linker 

provides fast incremental buibb 

Template And Multiple 

Inheritance support 

JJRCMB pmiuciivuy 

NESTED PROJECTS AND FOLDERS 

In you organize and navigate projecto 

multithreaded 

Environment 

bit you edit and ivritr code while eompiling 

Visual Architect 

builds your interface vtmafly 


All in all, Symantec C++ is a 
great way to develop the 
” fastest applications for 
Power Mac, 

THREE CDS FOR THE 

Price Of One. 

When you register as a 
Symantec C++ owner, 
you'll be enrolled in the Symantec 
C++ Subscription lor Macintosh 
program. Subscribers will auto- 
matically receive two free prod¬ 
uct updates (on CD ROM) so 
you’ll always have the latest fea¬ 
tures and tools. 


Leant mart about Symantec C++ on 
the internet at wu/uk tv man tt£. com 
Or tail l -80Q-&28-4777* foams ion 
9H22 for more information. 


MM 


SYMANTEC. 


C++ 

attar"" 


SYMANTEC. 


Olkt +ibil in l s A. iinir. miukil NuilunrK Inn nm m> IW Mir. AltburMl, Iw nkw infW-l.i. .’.ill I HHJ V,\-HMI In AikmIi.i. till 1 K79 (AT? In Lunfir, colt 7T 553111 

SpOUJilkt M 4 i imhIl-itlij-L ar^H*|lcr( < iipicii inn. All Atkrr tnklrrtjf ki Jrr th. pKtnprny rjV th*lh -cprUtivr lulilrii AM rfghti rcwitvtd £ I ■r'KS Symantec 







































definition, which well ger to in a bit. Tins i.s the class with the 
class_lD constant 'CpsW* mentioned earlier in the column. 
Last month, we embedded our message handling code in 
FictScroller.cp. This month, well create a subclass of 
LWindow and handle the messages (like 10Q1 from the Beep 
button and 1002 from the Picture,,, button) in our new class. 

■ In the function CPPStarterApp () : : CPPSrarterApp {), 
add this code at die end: 

UHp^ifltrar * :RfigisterClaEstCPlctSerollerWindov:;ciass_ID. 
CPLctScrollerWindow: :CcsatePictScroIlerWitidovStreain} : 

This code registers our new class, passing in the 
ciass_ID code and a pointer to the member function dial 
creates a new object, 

• In CFPS tar t erApp : : Obey Command (), comment ouL 
these two lines in the cmdNew case of the switch 
statement; 

// LStdBarton *theButton * 

// (ISttiSuttcm ■)rheWindowOFindPaneBylDl 1000 h 
//iheUtiuo n >AddU&tencr( thi# ): 

Since we will no longer be handling any messages in tills 
class, we no longer have to add ourselves as a listener. For the 
same reason, we can delete the function 
CPPStarterApp; :ListenToMessage(): 

• Delete the function 

CPPStarterApp:;ListenToMes sage{). 

• Save your changes and dose the source code file. 

• Now open the file Fi c t Sc roll e r* h, 

• Com mem out the reference to public L Listener m the 
first line of the CPPSrarterApp class definition: 

class CFPStarterApp : public Lapplicatlon 
/•* public LLiatener*/ I 

■ Comment out the declaration of the member function 
CPFStarterApp:;ListenToHessage(). 

//virtual void LIsieriToWensAge( MesaageT inMesaage, 

// void •ioparaa]; 

Your next job is to create new source code files to hold 
your new class definition and your new class source code, 

• Create a new source cotie file, 

• Type in this source code: 

#include <LWimkiw.h> 

^include <LListener.h> 

class CPictScrollerUindow : 
public LWindow. 
public LListener I 

public; 

emim I class^lll * ’CpaW I : 


static CFictSc rullet Window * 

CreatePictScronerWiudowSireiiaitLSl ream MnSt ream); 
CPictScrolIerWindowdStreain 'inStram): 
virtual void ListenToHessagetMessageT inHessage. 
void 'ioparan): 

virtual Bontcan AtlowSubReraoval( 

Lcumaande r * \ n$u|i): 

protected: 

Lvindov ‘laChildWimtov; 

virtual void FiniehCreateSelf0: 
void DifiplayPictBelectorO: 

1: 

* Save the source code file as CPictScrollerWindow. h. 

* Close the file CPictScrollerWindow. h. 


There are several important things to remember about 
CPictScrollerWindow,h< We are subclassing LWindow 
and LListener. We want to behave like a window and 
support listening to messages (in our case, we want a window 
dial responds to control clicks). We've removed the listening 
behaviour from ihe LAppIication subclass 
CPPStarterApp and added ti to CPictScrollerWindow. 

Notice the on urn constant class_ID with its 
corresponding four byte code 1 CpsW r . Lf you define your own 
class and will lx* adding listeners to a specific view, lie sure the 
c lass defines a class^ID and Ik sure that class_ID code is 
entered in the class ID field for that view in Constructor 

You might he wondering why we modified die class ID 
field in the Piet Scroller view (the view with the two push 
buttons), but not in the Piet Selector view (the view with the 
three radio buttons). That's because the class ID only matters if 
your controls generate messages and if you add a listener to 
listen to those messages, We won t install listeners for any of 
the radio buttons. See the call UReauimator:: 
LinkListenerToControls() in CPictScrollerWindow:; 
DisplayPictSelector(), The class ID acts as a kind of 
linkage, linking message senders to the class That will receive 
those messages. As you'll see, well handle the radio buttons 
willuHit using listeners, so we didn't need to modify the class 
ID field in the Piet Selector view. 

let s get 10 the CPictScrol lerWindow.cp source code. 

* Create another new source code file. 

* Type in this source code (you can ignore the comments): 

f lltC tilde “CPictScrollerWindow. h“ 
include <LStdControl.h> 
include <LPicture.h> 

Iinclude OlReaniaator.h) 

CPictScrollerWindow* 

CPictScrolli?r Window::Creu teFIr t Srrol 1 erWindovStreaE 
LStreani *inStreait) 

// This function geb«. .tiled 10 create a new 
// CPSctScrolJcrWimlow object 

I 

return (new CPictScrollerWindotf(inStreaiii)); 

I 
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They Say To Survive 
the Mac Needs... 



New 




A Miracle 


Clones 


We Say It Just Needs Better 
Development Tools 

Finally there's a complete RAD solution for the Macintosh—the rapid application development tool Mac 
developers have always needed, VIP-C is the fastest, easiest way to create complete, professional stand¬ 
alone Mac and Power Mac applications—period. If youVe tired of juggling editors, interface design tools, 

debuggers and compilers, or intimidated by the 




r~Fi nn r i nn r?n 

l J fZ&tiiff j Q 


WiihVIP-C's new Form editor you can design your applications 
interface and link events directly to your code! 


Introducing 

volumes of reference material required to get VIP-C 2.0 
started, end your search for development utopia 
here. VIP-C rw gives you everything you need in 
one box, at a price anyone can afford. And with 
VIP-C you program the way you want Work in a 
traditional bottom-up approach, or design your 
program's interface first with a powerful, integrated 
Form editor complete with plug-in control modules. Because your 
program is in standard ANSI C, it’s portable and completely compat¬ 
ible with other past present and future C development environ¬ 
ments. We Ve even built in a direct hot-link to Metrowerks 
CodeWarrior compiler. Help save the Macintosh, buy VIP-C today! 
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Order VIP-C Today! 
800-484-9817 (code 8472) 
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CPictliCrollerWimlow: :CFictSciuilerWindaw( 

LStreara * inSUeam) iLWindonUnS cream) 

// Ifcre* the constructor Notice that wtr just tii-c input parameter on Lu the 

// LWintkiw constructor Wc \mx jddtd 2 data member tv urn LWmJow >ubUa» 

// and initialize it here mOuld Window i> a pi winter to a Piet Selector window (akx 2 
// child window) if one exist?. If you elide in the Picture-, button, if 2 child window 
ff exists, it bi brought to the from If the chihl window does not exist, it ts created 

I 

*ChiIdWindow - nil; 

\ 


void CPictScrollerVindov::FinishCreateSelf() 

// FmbhCreateSclfO overrides its LWindow counterpart and is oiled automatically at 
// object construction time We'll add our two listeners: one for the Beep button and 
// one for the Picture- button, 

I 

LStdButton *th«Button = (LStdButton*) EfindPaneBylDUOOO); 
theButtoti’ MddListener (this) ; 
theButton - (LStdButton*) MndFaneRyIDilGQl): 
theButtoiiOAddLiatenarCthia): 

1 


void CPietScrullerWindow:!LlstenToMessage( 

Message! InMessage. void “ioParam) 

l 

switch (inMessage) I 

ease 1000: 

// Beep if the lkq> button fat prewed 

SysBe^pdOh 
break: 
case 1001: 

// Open the Piet Selector window if tin Picture button b pressed 

DlsplayPict£elector 0; 
break: 
case 2001: 
cane 2002: 
catfe 2001: 1 

if ({Mint32 4 HoFaraia) — Button-On) I 

// When Listen I o.HcssagcO gets called in response to a message front a control, it 
// puts the value of (tic control m the pararri mParaiii Wc only take an actum when 2 
// radio button b being turned on. Wc don't do anything in response to a button 
// being turned of! 

IJ'ieTiire ‘tbePIrture * 

(LPIclum**) nChlIdWindow >FindPunchy 113(2010); 
if UnHeasage T“ the Picture >UetPicturelDO ) f 
t he* Pie lure- >SetPiC lure ID (inMessa ge): 

Rest pic tFranter 

thePicture >CalcLocalFrameReet(pictFrame): 
thePicture ->ResizelaageTo ( 

pictFraitd .right jiictFraatn. left, 
p 1 cf Fr mx ♦ bn 11 am piet Frame. top, false): 
the? let tiro >Rc£rosh(J; 

lhi*Picture - (LFlcttii e‘ I'indFancBylDtlOOl); 
thePicture >tfeiPictureID(inHessage): 
thtPlstu re-MLaf reiki): 

\ 

I 

break; 

I 

J 

I 


void 

CPictScrollerWindov::DisplayPittSelectot() 

l 

// If the Pin Sckxlor window tlocsn't exist. well create it 

if [wChlldWlndw — nil) I 

mdilidWindow ■ LWindow;:€reateWlndow(2000* this); 

// This call searches the sped(kxl RidL resource (in this case. 2000) and calls 
// AddLbieucr for cadi item in Uic Kkli A Ridl resource b much like a Dfll 
// resource h b a bu of broadcasting pane IDs Each of our radio buttons b a 
// broadcasting panr {broadcasts a message) Alien we grouped the three radio 
// buttons, O instructor creaied a Ridl resource listing the three radio huuon pane 
// IDs Call UnldJtolCfToCoritrojsO if you have a Ridl., or AddlistenerO for each 
// broadcast ing control if you ckm't have a Ridl 

UReaninuj t a r: iLlnkListenerToControls( 
this, mChildWindow, 2000); 

// Gets the pane Ll> of die picture pane in the scroller w indow 


IPleLure "sc rollerPic lure = 

(LFieture*) FimiFaneBy 10(1003}: 

LStdRadioBution *theRadioBurton =■ 

(LStdRadioBur t on *)nChildtfindov'>FindPameByIDl 
fiOrolletPieture - >G@tPietureID () ): 

// Dur Pin soling code i> executed when a message b sent to IjstcrtToMessageO. 
// above This code also ralcuUte? which picture should he draw n in the miniframc 
// To he sure that this cmle gets executed, we first turn off the appropriate radio 
if button then turn it back on again 

thoRadioButton >SclValuc{ Buiton_Ulf ); 
theHadioBuiton->^etV£lue( Buttou_0u ); 
aChildWIndov->Sho¥(); 

I else I 

atChildWindow*>Select 0 ; 


Booleurt CPictSc ml itrWindnv :; AilowSubRemo va 1 ( 

LComaander "inSub) 

If Allow SuhKemowlo b tailed by PowctPhttU (by LWJndowiAtfenipiOoseO and 
// lWindow;!Du(3t»itO) when an LWindoiv is dosed. This is the hook w here you 
// migtit full up a "Save Changed dialog and not close the window if Cancel w as 
if clicked, In our case, w t won't put up this kind of dialog, Instead, w r cH just mark 
if the mt.h ild Window as nil and return in tv, saying it is OK to delete the child 
// wdodow. It sliould be anted that AllowSubRemovalO is called when any window 
// ibai lias a super--coimuaudcr is dosed ( n general, all windows will have a super 
if commamier - jierliaps the Upplicatton object) When you dose the parent 
// window, the AllowSubRtmovaJO of (he parent window's supereomnuoder (the 
if LAppHotiun objeet's AllowSubRemovalO) gets called. We ll kam about sub- and 
ff supercommamiens in 4 future etilumn 
I 

if {lnSuU ” taChildWitidow) ( 
taChi Id Window ■ nil; 

I 

return true: 

I 

* Save the source axle file ds CPictSc roller Window, cp. 

* Select fide* Window from the Project menu to add the 
file to ilu- project 

* Close tlic file CPictScrollerWiodaw. cp. 

Running the Project 


Tlutl\s about il. Run ihe projcei. If you removed otjjects liefore 
you copied last month's project, you'll have a minute or two to 
wait for the Mower Plant classes to recompile. Once your 
program runs, you'll see a window similar to ihe one in Figure 7. 



Figure 7 The mam, f’ictScroller window, stowing /wyj 
pmh buttons and a scrolling picture. 
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Microsoft 



Bring out the best in both worlds. 


Using jus! one toolset to target multiple platforms, you can 
increase your user base and knock months off your develop¬ 
ment time. With Microsoft* Visual C-h-'* Cross-Development 
Edition for the Macintosh’, you can reuse up to 90% of your 
code from your Windows-based applications to create the 
same applications for the Macintosh*, with the familiar 
Macintosh interface. 

Features Include: 

■ Port Windows^ based features easily to the Macintosh, 
including multiple document interface, print preview, and floating 
toolbars. The Windows Portability Library does the work for you, 

■ True native Macintosh programming. Program directly to 
the System 7 API to lake advantage of unique Macintosh fea¬ 
tures such as Publish and Subscribe. 

■ Recompile for the Mac ": Target both the Windows and 
Macintosh operating systems using just one set of source 
code written to Microsoft Foundation Classes and the 
Microsoft Win32* API. 


■ Power Macintosh "Support: Including a fully optimizing 
compiler and integrated debugger that adapts to the 
PowerPC rM chip when displaying information in the register 
contents and disassembly windows. 

■ Code Fragment Support: for the Power Macintosh which 
translates to better code sharing among applications and 
faster, trimmer applications with very little development over¬ 
head. 

■ OLE support . You can now easily port your Win32 and 
MFC OLE applications to the Macintosh using OLE for the 
Macintosh version 2.06. 

■ ODBC support : You can call ODBC directly or use it 
through the appropriate MFC classes. 


For more information: http://www,microsoft.comVisualc 
or call (800)719-5577. 


Microsoft 

| WHt Kt QQ VQU WAN* to CQ TOOAVr 


"Thin inlcf ori loahMri required Vinual Ct i tof Inter platforms, available separately 

Microsoft Corporation. All rights reserved Microsoft, Visual C++. Win32, Whom do you wan/ to qr> fodny?. and Windows aro oilhor rag'slnrad imdemnrtcs or trademarks of Microsoft 
Corporation in Iho United States arrcltor other countries. Macintosh is a registered trademark and Power Macintosh is a trademark of Apple Computer Inc , used under license 
Mac is ii Eimtortuirk of Apple Computer, I nr; Intel Is a fogistnrud trademark of Mol Corporation, PowerPC let ,i IrartaiTUtrit of international Otjulrtess Mari I linos Corporation 












Is Ultimate Ii61 Puli' In Mug Mil! 

IMPORT i~ EXPORT + THUMBNAILS h 36 FILE FORMATS + DISPLAY I IMAGE GUARANTEE 
PRINTING + COMPRESSION + IMAGE PROCESSING + COLOR REDUCTION 


IJUmtuEu Imaging Toolkit 

AauSoli provides Lb- ultimsiie imilling hit ilk it solution 
with the highest pcrl'ormance. mosl iurrnnls platforms, 
most cemplfk- API ami ihe husi pricing. That is why wv 
are the industry leader and why over 51 KJO companies 
have chosen AecuSnlt I'or iheir imaging needs! 

Performance 

AccuSuli has always heeii known as I lie jtarfDonanOt: 
leader. We know lhal you want Lite fastest imaging 
possible: and lhal fuxi is never fusl cntrugli. Then: lore, wu 
constantly work on improving performance in keep os 
(and you) ahead oft he coni] >eii icon. 

Quality 

AccitSuR has become ihe leader in imaging luolkils due 
to uur unhung commitment Lo quality. Not just | undue L 
quality, which can lie seen in uur unique guarantees. liui 
also service quality fnun emr Special last delivery 


Rtattomis Smincirrfld Mjil ntttwfi I umbi Macintosh 
Winclutws. WinMXNT Q0!, DDS32 VB3L0CX. l) : 7Z 
1nd'rrj. SUN OS, Soim HP-UX. AtX,INIX SCO 
Over 36 File Formats Supported, MAC, HH.jrLi. 

C . i i-' IB. OCX. GIF’, BMP. WMF 

m I'.WPG LPS 1 , Kf X, RLL, LV, CALS, M I, CLP. XWD, 
IMG, IFF. SUN. XBM ICO. IfJfTA, GX2 XPW -AflGlI CUT, 
BWfcPSB* MSP, PN6", Photo OO 4 


program, lop-mied technical support and rock-solid 
technology. 

Mat & Power Mae 

The Mac versions oft he Image Formal Library provides Cudo 
Resource Files thal are compatible with any Macintosh 
development system including ThinkC. M?W. and Code 
Warrior These versions use tire same interface as other 
versions lor easy cross-platform development and are 
available for both Mac and Power Mac systems. An XCMD 
version is also available. 

Pi t i Gold 

The Pm Gold versions of our imaging toolkits are unbeatable 
lor pcrlomumo; and special features like scale In gray. mi tv 
degree rotation, sub-second decompress & display, sub- 
second screen rotation, huge image handling and more If you 
waul the best performance available anywhere, al any price, 
ibis is il 


3 © 

MINUTE 

Delivery 


Cross Pint form 

With this toolkit, you can sell your applicability on 
many di tie rent plal forms without having lo rcetwjc; Ihe 
i m jgi ng port ion, AceuSt' ft "a cross pi at 1 1 irm dc.s tgu i s 
tailored tor easy porting, and since we support A E E 
platforms, your produces can he sold to every market 

Order Today 

(Tall now in id you can start writing high peiTon I imice 
imaging applications in less Ilian an hour. Our unique 
'ttl mirinlc delivery pmgnim is also jbe lastcst iti ihe 
business! 


ToU Free: (800)525-3577 
Internet: http://www.aecusoft.com 
CompuServe: Go AccuSoft 


AccuSoft 

/ / 'ig h Pe rfo n mu i ce I mag i n g h 



Loo* for Hut ACBuSqtt 
irmtje Guarantee' 1 * or 
ttxt AccisSofl trademark 
art your favorite software 

poult tote UK H KUthinmni 
of superior quality 


You mo start tialng tins 
AatslSott fir Or foul U nfay 
_v *jji...i._iimi ty taking urinrnlage 

/A/NUTF * vur ynn 7 ue ^ 

B UeKvery Pfcpfam 


Delivery 


Two Westborough business Park Wes thorough, MA 01581 Tel 1508) 898-2770 FAX (508) 898-9692 

All ,'iiwl hi:iHLl ruiif, ail." 1 i;ilI iii:ii 1 t m i.'ihJrri-|j li:nlrni:nks ol llifii iL'^fhx'UVL: (iwjiciv 

DIWJ AiC»Sn|| C\w|Mri»lli*ii 'Ml Wiiil.l- III .. I I ’^MlUalilr «.-uli hr. ns.- limn Umi-.v- ’• *Hiy IlftfHliL' lilt >Efu-ii- f\l. n, lib' 11 iiiiiiii li«i tilt- I IUi\L,l ■ II iK 1 Hv.nl fliFv llHVi KOI i l i | ii if-. srjvn.iU III .1. Ill 111! K ■ -.! .11. '■ 


Click on the Beep button. You should hear a beep. Click 
on the Picture... button. A Picture Selector window should 
appear (Figure 8), Click on a few radio buttons and verify dial 
the picture changes in both the mini-frame and in the 
PictScroller window. Click on the PictScroller window to bring 
iL to the front. Click on the Picture... button again. Notice 
that the Picture Selector window came to the front, as opposed 
to the program creating a new one. 

TIJ Picture Selector 

(£) Sun 
O Moon 
O Red car 

Figure 8, 7 he Picture Selector window. 

Select Neiw from the File menu and create a second 
PictScroller window. Click on that windows Picture.,. 


button to bring up a second Picture Selector window, Click on 
radio buttons in each Picture Selector window to convince 
yourself LhaL each is Lied only to its own parent window. Now 
close one of the PictScroller windows. Notice that that 
window's Picture Selector window also disappears!!! As I said 
in the program comments, this all has lo do with commanders, 
sutxommanders, and supercoinmanders. Well get into all that 
in future columns, 

Tili. Next Month.*, 

Well, that's about it for PictScroller. 1 think we ll start next 
month's column with a brand new program. See you then..* 


TO RECEIVE INFORMATION ON ANY PRODUCTS 
ADVERTISED IN THIS ISSUE, 

SEND YOUR REQUEST VIA INTERNET: 
PRODLIClTNFO@XPLAIN.COM 
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Measure 

your application development time 

with a 



instead 
of a 

no", 1 ";' “ • 


Pictorius brings real Power and Productivity to RAD m ™ D D JT 

The Tfest Drive CD-ROM contains limited-use versions of Prograph CPX and Peregrine and Prograph Classic Freeware 

If tin 1 'list Drive CD-ROM is missing cull us ;il I -KiKl -927 AWJ and we'll rush one m you 



peregrine 

A % mu tn*is »r, . ~ f 


classic 

iv ixjtMvr. winr.i 


Build applications 
as fast as you am visualize them 

HUM s 

fwSjt & hmu^Ui Owniu'K 
Hm *MH I W IUWES A%fi HMmiHT 

1 1 program written in Prograph 
typically tikes about one third to one-half 
of the programming time needed to write 
an equivalent program in a textual 
language like C„ 


Prograph allows for rapid 
program ilevelopment with a minimum 
of effort and debugging.” 

fast 

% Du . S(3fit fl. StKIHWN 

IHYta***:* M*rTmi Mumm 


Pushing 


Builti cbent/senvr af/ftHatlinns and databases 
as fast as you can visualize them. 

BONUS 

Pm® <u> i Hums vtn Mwurr 

FKK 41) Dktamu Mii.itwiit'i Tinii 

1 ‘We’re an Oracle shop 
and it's usually a huge effort to build 
a customized front-end but Peregrine makes 
lhal a lot easier. With die aulomatic 
generation of input and output windows, 
we am have an app in IS minutes dial’s 
ready for lesling and customizing.” 


Introduce yourself to visual 
object oriental development with 
Prograph Classic Framin'. 

Prograph Classic freeware 
is a great Introduction 
to the Prograph world 
of rapid application development 

Ppgrade to Prograph CPX 
when you’re ready for 
professional lew I application 
development. 


Hum Mr‘Owitu \ 

StMIOR TkUMlGAl. ft’WiALLST, 

I1T MyktrimIi 


ictorius 

INCORPORATED 

the Limits of Productivity 



Mac' 1 )S 


1-HU0-9-7-4847 www.pictoriLiS.eom sales#pictoriujua>rii 


S)sivm toqulmucnt* iVitrftrt™ IWJti Im u Power Mac or Macintosh ((5*040 or hotter) with System of liiftber 20MB of RAM awl u l>Mli purl Hum i£MEI of hurt! ilUk sftra Progrunh m n-ijinn^ 
;i (te nr Rivnler with System 6.0.7 nr higher Minmmm partition rind 17MB of iM Ptografii Classic requires a MAC Hm or bettor widi liHk. a haul disk tmd 2MB RAM 

An rRAwiiwtts m) maamm m mwnrs tw Twat MBP&cnvii QDfiVNMRi 








NEW BOOKS FOR MACINTOSH DEVELOPERS FRO 




Advanced Color Imaging 
ini il.\■ Mac OS 



by Dove Mark 

Anyone who can use a Mac can learn C, and 
all the information needed to do it is right here! 
Learn C an the Macintosh, Second Edition, has 
been revised and updated to include fresh code, 
enhanced lessons, and a CD-ROM with Metrowerks 
Cade Warrior Lite and an assortment of games, 
shareware, graphics, and plenty of other neat stuff. 
Book/CD-ROM, 496 pages 


by Joe Zobkiw 

Here's some practical help for creating code 
resources and code fragments for the Macintosh 
end Power Macintosh. Rather than gathering and 
indexing code, the author teaches you more a haul 
how the Mucin tosh system functions as a whole. 

He also provides hard to find information about 
techniques used to structure and build fat, safe 
lai, and accelerated code resources for use on both 
6S0xO and Power Macintosh. All code is reusable 
and is provided on the disc, along with Met rower k$ 
CodeWarrior Lite. 

Dook/CD-ROM, 528 pages 


by Apple Computer, Inc. 

This is the official guide far enhancing your 
Macintosh software's color capabilities. Covering 
the Color Picker, the CatorSync Manager, the 
Palette Manager, and the Color Manager, the book 
provides conceptual inf or motion and code samples. 
Its companion CD-ROM offers a complete reference 
to the data structures, routines, and resources 
described in the book and contains a sample 
application demonstrating ColorSync programming 
techniques. 

Book/CD-ROM, 352 pages 


Danny Goodman‘s 

= Apple Guide 
Starter Kit 


Danny Goodman 
ci J eremy Joan Hcwes 



1 


by Danny Goodman 
and Jeremy Joan Hewes 

Two highly respected exports offer a different 
approach for creating your own Apple Guide 
databases. With this program, you can moke 
guides quickly and easily, without having to 
learn a scripting language, write coded files, 
or use several different files and programs to 
produce your database. The authors provide 
advice and tips oa how to design a good Guide, 
from planning through testing, revising, and 
indexing. 

Book/disk, 320 pages 



by Jon Wiederspon 
and Chuck Shaft on 

This hook is a definitive guide to setting up 
and running a Web site on the Macintosh, 
written by two acknowledged experts in Ike 
Held. It skillfully teaches you everything you 
need to know about using WebSTAR, the best 
known HTTP server software and its shareware 
predecessor MocKTTF, os well os about wriling 
CGI applications lor your server. A special 
version of WebSTAR, plus tons of useful 
software, are on Ike CD-ROM. 
Book/CD-ROM, 384 pages 



by Apple Computer, Inc. 

Have you ever needed to find current Information 
about using o crucial toolbox call while in the 
middle of writing your application? How with just 
a dick ol your mouse, you can get instant access 
la more than 5,000 toolbox calls. This CD-ROM 
database contains all routines, data structures, 
and constants as documented in Inside Macintosh. 
With a lightening fa si search engine, it helps you 
find key data structures, resources, constants, and 
functions when you need them the most. 
CD-ROM 





























DDISON-WESLEY BROUGHT TO YOU BY 


Ml 



by Kill Hftrtsltr 

tierod Wdeo Gomel H written lor the 
wannabe gomes writer locked inside every Mac 
programmer. This book provides a teem-by- 
example tutorial on the ins and owls of Mac 
arcade-style gome programming in C It leaches 
gome programming lore, including basic game 
theory, Sprite animation, sound, and interaction 
techniques. This book is a must-read lor serious 
programmers and hobbyists alike, 
Book/disk, 496 pages 



Design 

o 


Bruce Togiiazzini 


by Bruce Tognazxmi 

Respected industry futurist, Bruce * 109 " 
Tognanini, presents bK vision of our 
technological Mure, detailing the steps 
computer professionals need to lake to deliver 
new technologies thal will profit the industry 
and benefit society in general. This book 
contains Tog's insights on a wide range 
of topics bom quality management 1 o the 
meaning of standards, and responses to 
queries supplied by designer! and developers. 
432 pages 



by Apple Computer, Irsc 

This is the official reference for (he implemen¬ 
tation of OpenDoc on the Mac 01 The book 
describes the component software re volution 
and explains how lo develop for H an the 
Mac OS platform. An accompanying CD-ROM 
contains a complete reference lo the OpenDoc 
programming interface, and an extensive 
collection ol lasted, reusable sample code. 
Book/CD-ROM, 60S pages 


ORDER THESE BOOKS AND CD'S FROM MACTECH MAIL ORDER STORE NOW!! 


INSIDE MACINTOSH 


Title 


Mark, Learn C chi the Macintosh, Second Edition 


Mudech Mail Order Stare 
Retoil Price Special Discounted Price 


$34.95 


$31.46 


w ^ 


Zobkiw, A Fragment of Your Imagination 

Apple, Advanced Color Imaging on the Mac OS 

Hemler, Sex, Lies, and Video Games 

$39.95 

$36.95 

$34.95 

$35.96 

S33.26 

$31.46 

jUjiy™ P 

mnm ;j 

■ 

Tognanini, Tog oti Software Design 

S29.95 

526.94 

zfl 

U ‘'Katyr 

Apple, OpenDoc Programmer's Guide 

$44.95 

$40.46 

ass'* 


Good man/H ewes, Apple Guide Starter Kit 

$34.95 

S31.46 

- MH 

= : WM 

1 

Wiederspun/Shotton, Plan, and Manag. Web Sites on the Mar 539.95 

$35.96 

= m 


Apple, Woe Programmer's Toolbox CD-ROW 


599.95 

p 

■/ 

Apple, Inside Macintosh CD-ROM 

-- 

$99.95 


j 

Apple, Apple Guide Complete 

$39.95 

$35.96 


by Apple Computer, Inc. 

Now the 75-book inside Macintosh series is 
available On one CD. inside Macintosh CD-ROM 
contains the electronic text lor 25 books from 
Inside Macintosh—the essential resource for 
prog rummers, designers, and engineers. You can 
have instant access to more than 16,000 pages 
of information contained in the inside Macintosh 
suite, including the QuickDraw QX library. 
CD-ROM 


Also Available: 

APPLE GUIDE COMPLETE 
by Apple Computer, Inc. 
Book/CD-ROM, 544 pages 


All of the above books and MORE, ore listed in the MacTech Mail Order Store 
at these Special Discounted Prices. 

Order by Moil, Telephone, Fax, or E-Mail at the following addresses: 



P 0 Box 5200 

Westlake Village, CA 91359 5200 
Voice (805) 494 9797 
Fox (80S) 494-9798 


AppleLink: MT CUST5VC 
CompuServe: 71333,1063 
Internet: tus1servite@iplain.cant 
America Online: MTCU5TSVC 
eWorld: MT.CoslSvc 


You may use your VISA, MasterCard or American Express; or you may send check or money order (in US funds only). Don't large! 
to include your nome, oddr ess and phone number wilh each order [(olilornia residents only, odd 7.25% lax to your order.) 















































Power Too Abundant to Meter 
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http://www.neologic.com/ -neologic/ 
Download the Architectural Overview! 
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Powerful 

NeoAccess and NeoShare are the most powerful 
object-oriented' database engines available They 
display electrifying performance—up to ten 
times that of competitors. Behind an elegant 
programming interface is a high performance 
query engine utilizing: extended binary trees 
and binary search algorithms tuned for short 
access times, dynamically combined, collapsed, 
and compressed indices, and object caching for 
lightning fast access to previously used objects. 

No Runtime Fees 

Get the power of NeoAccess and NeoShare, and 
avoid the expense and administrative hassle of 
feeding the runtime fees meter You pay one 
affordable price no matter how many copies of 
your application you sell or use 


Cross Platform 

Others may promise cross-platform 
development tools—NeoLogic delivers 
NeoAccess is a set of C++ classes designed for 
use with popular compilers and application 
frameworks on Windows', Macintosh 7 , and 
Unix u platforms Full source code is included 
so it can even be used with custom frameworks. 

New in NeoAccess Version 4.0 

NeoAccess now supports Microsoft Visual C++ 
4.0 IDE. MFC 4.0 and the latest version of 
Metrowerks CodeWarrior A new stored query 
class increases speed and flexibility in accessing 
objects. Inverted Indices and full word search 
capabilities ease working with many-te-many 
relationships. And all new on-line Hyper- 
Reference guide, documentation, tutorial, and 
sample applications get you up to speed quickly 
and pro vine a complete set of reference material. 


Scalable 

NeoShare extends the core features of 
NeoAccess to client/server applications 
NeoShare includes the NeoAccess Toolkit and 
everything you need to create data intensive 
distributed applications. Its advanced 
client/server architecture provides shared access 
to objects by multiple networked clients 
Combine client and server functions into a 
single application or create separate client and 
server applications. With NeoShare you have 
complete flexibility in the design of your 
distributed systems. 


Proven 

Thousands of commercial and in-house 
developers have already found that NeoLogic's 
technology enabled them to build last, 
powerful applications in record time That's 
why NeoAccess and NeoShare based 
applications are already operating on millions 
of computers Tap into the power for your next 
development project! 


neo*logic 


Powering Development of Object-Oriented Applications 
NeoLogic Systems 14 50 Fourth 5 L Suite 12 v, 510.524.5897 

neologfc^neoloaic.com Berkeley- CA 947*0 1 510.524,4501 







CRABB'S 

APPLE 


By Don Crabh 



Tomorrow s Developers 


I just spent a surprisingly enjoyable two 
days as a presenter and keynoter at the 
10th Annual Illinois Computing Educators 
conference in Addison, Illinois, outside 
Chicago, At this conference, today's R-12 
educators met to discuss the latest 
computer software and hardware, the 
I as test trends in computing pedagogy, the 
latest methods in computer laboratory 
management, and the busiest methods for 
moving their kids onto the Internet and 
the World Wide Web. 

I say “surprisingly enjoyable," 
because I found myself learning jusi as 
much about the state of Illinois K-12 
computer education as I taught ahoul the 
state of current computing technology 
and programming environments, 

I learned Lhat many of today's kids, 
especially those in grades 7-12, are 
chomping at the bit to learn the guts of 
computing, how and why it works, and 
nut just how much fun it can be. These 
expectations cut across racial and 
socioeconomic groups. This information 
couliters the wtdely-rqx 3 tied steret>ty[ie 
that only nerdy white boys from wealthy 
suburban families are really interested in 
learning computer programming, 
computer architecture, computer 
networking, and software engineering, 
What the thousand or so assembled 
teachers taught me was to forget that 
perception as they told me one story after 
another about inner city Africa n- 


Amcrican. Hispanic, Asian, and other poor minority kids (girls and 
boys) who stayed alter school just to have a bit more time to use 
meager computer resources. And just how many of these kids 
were not just computer-doodling, or banging the Internet and 
WWW for the hell of it. These kids are demanding to be taughl 
how to put computer technology to use for themselves and their 
families and how to buy into the digital revolution. 

And da limit, we re the folks who ought to be stepping up 
to tile task to make it happen 

Despite the best intentions, programs, and efforts of the 
teachers 1 talked with, the minority kids just aren't getting the 
programming training they want and need. Despite the best 
intentions, programs, and efforts of the school administrators I 
diked with, the inner city kids just aren't gelling the programming 
training they want and need Despite the best intentions, programs, 
and efforts of the corporate donors I talked with, the poor schools 
just aren't getting the computer and networking resources they 
want and need. And despite the best intentions, programs, and 
efforts of the governmental educational chiefs I talked with, the 
poor, minority, inner city kids arc being overtly and covertly 
locked out of the digital revolution that is reshaping America. 

And damn it, we’re the folks who ought to be stepping up 
to the task 10 help fix these problems. 

This is no longer just an educational problem. It s a problem of 
1 he future of this country. Computing and digital information 
processing are the wave of the present and the wave of the future. 
Tor as long as any prognosticators can see. Arid if we don’t start 
digitally enfranchising all of our kids now h regardless of their race, 
or how much money their families make, or what sehcx>l they go 
to, we re going to create a caste system worse than any imagined in 
colonial India under the Raj. We re going to create a country where 
the haves and the havenots arc not defined so much by bucks as 
by bytes. The digital literati versus the digitally disadvantaged. 

And damfiit, we're the folks who ought to be stepping up 
to the task of providing the guidance, the resources r and the 


About Don Crabh- Don is a contributing editor and columnist for Mac Tech, Mac WEEK, Mac USER, Mac/Chtmpo, MacToday, 
Win95User, CompukrUser, The Chicago Sun-Times Features Syndicate, The Springfield Unum-News, PC Magazine*, and about a 
million other publications, Don welcomes comments at his Internet address: don_crabb@mactech.com. You can also check 
out Ids WWW Home page at http://www.es.uchicago.edu/~decc/. 
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ScriptX j unquestionably has the potential 
to become multimedia's PostScript." —osgrtaiwedio- 

_ llaqiieslioiiiihly^-llie Premier Multlixieil!a_PIiil{Quii« 

ScriptX allows you to develop for Macintosh, Windows, 
and OS/2 systems at the same time. And to ship single titles for oil 

Unquestionably Advanced. 


With SaiptX you con develop titles impossible to create with other development tools. 

Unquestionably Reu sable. 

SaiptX object-oriented design mokes it simple to reuse 
your code. Objects can be perfectly synchronized and ore \ 


easily moveable, even ocioss the Internet. 

Any Questions? 


Call for FREE information, or to boy our Script 
Language Kit for 5/95, with our no-hassle 60-bay 
money back guarantee. 


1-800-652*5343 

http://wwvu. kaletda xom/ 



peoplepower to give our educators the tools and software they 
need to extend the digital domain to all K-l2 students, not just 
those with the fancy multimedia PowerMac setup in the media 
room at home. 

What I am suggesting here is simple, hut executing it will 
require a real committment on the part of individuals and their 
companies, Here we go; 

1. Mac developers as a group are among the best programmers 
on the planet. That's not a boast, it s a Fact. Mac hardware 
and software companies as a group are among the most 
innovative corporations you can find. That's also not a boast, 
it’s a reality forced on them by a MacGS marker that often 
defies description, and by their primary partner (Apple) that 
frequently defies logic. 

2. Mac developers need a cause to rally around beside defeating 
Microsoft or learning to lx- independent with them. 

3. The U.S. is at a crossroads in its ability to provide a proper 
computing education for all of its schoolage kids. 

4. Mac developers and their companies need to get involved 
supporting K* 12 computer education efforts in die LFS., by 
offering their expertise, pro bono, on how to improve and 
extend programming and computer engineering curricula; by 
offering their services, pro lx mo, at teaching die teachers; by 
offering their spare- time, pro bono, towards creating killer 
computer pedagocial apps to help the havenots catch up 


with the haves; and by offering donations of equipment, 
networking resources, and software to make all of these 
initiatives work together. 

In short, what I am suggesting here is the private equivalent 
of a Vista or Peace Corps for all American kids revolving around 
digital technology, with a strong emphasis on programming and 
.software development as keys to understanding how the digital 
world is working and will work and how to make the most of it. 
Software and hardware companies would grant paid release time 
to their developers to work in this program and release time to 
their managers to establish it, staff it, and gel it under way. 

Naturally, we’d buttonhole Apple to be the corporate 
bandwagon upon which we could liitch our pedagocial wagons. 

Let's call this new initiative the Digital Corps of America 
(the idea makes sense in many other countries, too). If you are 
interested in discussing this concept and want to help organize 
it, drop me a line at decc@cs.tichicago.edu. l will try to organize 
some electronic meeting forum or list to kick tilings off 

In tile long run, with the Digital Corps of America we end 
up helping to "re-melt the pot" Americans are so fond of 
thinking represents the American Way, I rat in a way that makes 
sense in the Digital Age. And we lie Ip firmly establish the very 
computer markets we are now- frying to niche ottt in our daily 
struggles by creating a whole new class of computer literate 
customers. Sounds like a win-win to me, ^ 
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Protect your software investment with SentinelEve3 - the world's lending protection for Macintosh software. 


You work hard to develop software, 
don't lose your sales to piracy 


Over 8 million Sentinel* keys protect 
soil ware worldwide. In fact, 50% of 
all protected software has a Sentinel 
key, from Uainhow Technologies. 



Slop piracy and ensure 
your sales with Sentinel 
> Jt r $ the easy way to 
Implement protection 
that's transparent 
to your software 
customers. 


Your software and your customers 
deserve the best protection. Only 
Sentinel keys give you leading-edge 
security, ISO 9002 certified quality and 
99-985% reliability. And only Rainbow 
can provide products, service and 
support in over 70 countries. 

Find out wby leading Macintosh* 
developers like Adobe* r Apple' and 
Autodesk* protect with Sentinel - call 
today for a Frif Sentinel Software 


ProUetion Guide. Or start protection 
now, order a Sentinel Developer's Kit 
featuring the Sentinel 
CD-ROM. IPs every¬ 
thing you need to sell 
more software and 
make more money, 

( 800 ) 852-8569 
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^RAINBOW 

rfClilLBBIIS 


Visit Rainbow Technologies on the internet at: http://www.rnbo.com 

WORLD HEADQUARTERS: SO Technology Drive, Irvine, CA 92718 ■ Ttf: (714) 450 7300 ■ Fax (714) 450-7450 
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CUTTING EDGE 
TECHNOLOGIES 


Be 


By Peter Potrebic and Steve Horowitz, Be foe. 



Opening the BeBox 


A programmer’s 
introduction to the Be 
operating system 


Introduction 

He, Inc. was founded in 1990 by Jean- 
Louis Gassee, former president of Apple 
Products, to design and build a new 
computing platform. The first product 
offered by the company is a 
multiprocessing computer called the 
BeBox. It contains two PowerPC 603 
processors and a new, modern 
operating system. 

This article will describe some of 
the philosophy behind the design of the 
Re Box. It will go into some detail 
explaining the system software 
architecture with an overview of the Ivey 
components. The article also includes 
source code and a description of a 
sample application, to give you a feel 
for writing software on the BeBox. For 
more detailed information on Be and 
the BeBox, as well as a look at 
developer documentation, please visit 
our web site: http://www.be.com. 


Design Philosophy 

The BeBox was designed with the technology enthusiast in 
mind. As Jean-Louts is fond of saying, "Only the lunatic fringe 
will lead us to the truly innovative applications. 11 Every machine 
is programmable right out of the box, and comes bundled with 
programming tools from Metro we rks and full developer 
documentation. We do not expect that die BeBox will be your 
first computer - it will not run any Macintosh software nor will 
it run Windows. However, if you are excited by new 
technology, know how to write code, and have a pioneering 
spirit, tlie BeBox may have something to offer you. See Figure 
1 for a screenshot showing a few running Be applications. 



Figure I. Sample screen shot 


Peter Potrebic and Steve Horowitz - When not out riding one of his bicycles up a really big hill, Peter Potrebic is a happy 
software engineer at Re Inc. He's worked at Be for the past year anti a half, Before corning to tie, Peter spent eight years at 
Apple Computer engineering software for Newton, N IK, and MPW, Steve Horowitz is a software engineer at Ik' Inc. When 
not giving demos at Be he can generally be found chasing pucks around ice rinks or watching others do the same. Having 
worked at Be for four years, Steve has finally given up hope of !>eing called up by the Sharks. Prior to Be, Steve worked at 
Apple Computer for two years as an engineer and four summers as an intern. 
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History has shown that it is difficult to predict the markets 
where a new computer might be successful. We believe that 
developers will lead us, and so our goal is to provide a unique 
set of system software features, a low-cost hardware platform, 
great development tools, and an extensive developer support 
program. Additionally, we plan to help our developers reach 
their potential customers by offering electronic distribution of 
their software on the Be web site. From all of tills we hope to 
see new and innovative applications for markets we could not 
possibly envision. 

The BeBox was designed by an extremely small team over 
approximately four years. We started with a clean slate and 
focused on a couple of key ideas. One of Lhe fundamental 
design techniques was to give responsibility for each major 
system component to one person. By concentrating the 
decision-rnaking process, the engineers were allowed a great 
deal of freedom without having to justify and get consensus for 
every design decision. However, since most of the components 
were interrelated there was enough informal interaction to 
assure that we were all on the same track. This approach 
allowed us to avoid some of the pitfalls of overdesign and 
resulted in what we believe is a simple, efficient, and fast set of 
system software components. 

Another decision we made early on v/as to take a C++ 
light approach. We wanted to use an object-oriented 
programming language, but not necessarily to use every feature 
the language had to offer. Programmers need not be C++ 
experts to program the BeBox. This decision makes the system 
more approachable by a larger number of people with a varieLy 
of programming experiences. It is also fairly easy to absorb the 
Be class libraries and get a simple Be application up and 
running quickly. 

System Software Overview 

The design of the Be operating system Ls based around a 
client/server architecture, with a microkernel aL the lowest level 
providing all the OS functionality used by the higher levels. 
The developer makes use of a set of client-side C++ class 
libraries and C functions to write Be applications. 

The system software consists of a number of key 
components. Several servers are built on top of the kernel 
including an application server, storage server, network server, 
and media server. The servers run in separate protected 
memory areas and implement the majority of system 
functionality available from the C++ class libraries. The class 
libraries are broken up into a series of kits which export the 
functionality from the servers to the client applications. Among 
the kits available to Be applications are an application kit, 
interface kit. OS kit, device kit, media kit, midi kit, networking 
kit, and storage kit. The details of all of these kits are beyond 
Lhe scope of this article. Instead, this article provides a brief 
summary of each server's basic functionality, followed by a 
description of the major pieces in a simple Be application. 

The Be kernel provides many fundamental system services 


to the higher-level servers including Lhe ability to deal with 
multiple processors, true preemptive multitasking and 
multithreading, memory protection, shared memory, 
semaphores, virtual memory, shared libraries, and loadable 
drivers. The kernel scheduler supports multiple processors in a 
manner completely transparent to the application. Phis anti 
other features of the kernel provide an extremely fasL and 
efficient foundation upon which the rest of the operating 
system is built. 

The application server is Lhe main server with which 
applications communicate. It is in charge of all the window 
and view management, graphics rendering, font management, 
user interface interaction, event handling, and so on. One 
important aspect of the Be programming model implemented 
by the application server and interface kit is that every window 
in Lhe Be system is given two separate threads. The application 
server maintains a thread on the server side, which 
communicates with a client-side thread running in the 
application's address space. This allows all windows to update 
their contents and respond to user interaction asynchronously, 
and is a major factor in the overall responsiveness of the Be 
system, This also means that any multiwindowed Be 
application is automatically multithreaded and multiprocessing 
with little work from the developer. You can, of course, spawn 
more threads for your application using other classes in the 
application framework or lhe lower-level kernel functions. 

Another important server is the storage server. It 
implements the built-in database functionality in the Be 
operating system. The storage server allows programmers to 
design tables that describe records, create and delete records, 
and receive notification of database changes. With the 
integrated database, every file on rhe BeBox has its own 
database record. This acts as an extensible storage system, 
allowing programmers to create unique tables containing 
whatever information they want about a file. The fields in 
these records (us defined by the table) are then searchable and 
viewable by all applications in the system. Additionally, the 
storage server implements a "tive ,? query mechanism that allows 
any Be application Lo construct a query and then, if desired, get 
notified continuously of any changes to the set of records 
located by the query, This behavior is seen in the system 
Browser (an application akin ro the Macintosh Finder) which is 
part of the operating system, but this service is available to all 
Re applications. 

The network .server provides basic system networking 
services, it implements the TCP/IP protocol stack and provides 
a socket interface resembling Berkeley sockets. 'There is also a 
PPP layer included in the server, and support for Ethernet. 
Standard networking Loo Is such as ftp, fLpd, and telnet are 
included with the Be system. 

The media server provides a set of tools for manipulating 
large streams of multimedia data. This server handles the 
transportation of buffers of media data through a pipeline of 
interested data handlers. Each handler can subscribe ro a 
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media stream* By subscribing, the handler is given a chance to 
manipulate or read ihc data us it passes through the sysFem. 
The buffers are implemented as shared memory areas, which 
can lx i read by multiple applications in .separate address spaces 
without having to copy I he buffers between applications. 
Additionally, you can use the media server to synchronize 
separate media streams, using a global scheduling object that 
allows easy coordination of audio and video data. 

Bi; Application Basics 

A simple Be application will primarily make use of the features 
in the application kit and the interlace kit. The core objects 
used by an application are BApplication, B Window, 
BView, BMessage, and BLooper. BLooper (feel free to call 
h *bloopcr") is the main object used to encapsulate thread 
spawning and message handling. Hath BLooper object has its 
own thread that responds to messages sent to it by other 
objects. Since BApplication and BWiodow both inherit 
from BLooper they are automatically message handlers 
running in their own threads, 

C enera 11 y, a BApplication object is created First* It runs 
an event loop in the main thread of the application, and is used 
for basic messaging between applications. It can also be used 
to exchange messages with windows or other threads in your 


application, Additionally, the BApplication object receives 
notification of files to open at launch time or once the 
application is running. The BApplication object is the 
central control object from which other windows and objects 
arc created anti can be used to synchronize sharing of global 
objects within an application. 

Most of the communication between threads, windows, 
and applications in the Be system is done using a RMe&sage 
object. A BMessage has the ability to contain an arbitrary 
number of ‘data’' entries to pass information around, as well as 
a "what” field to tell the receiver what type of message it is 
receiving. BMossages are die fundamental objects used to 
share information lx?tween threads and applications, They are 
also used to implement drag-and-drop and the clipboard. 

To actually display anything in your application, you must 
create a BWindow object and add a BView to it, Hach window 
you create, by virtue of its BLooper inheritance, will spawn a 
new thread to handle drawing, messaging, and user interaction 
without monopolizing your application s main thread, 
Windows are also the containers of BView objects, and handle 
the display of any drawing thal takes place in a view. A 
BWindow can contain multiple views and. in turn, views can 
contain other views. Each view has its own drawing 
environment and alt drawing is automatically clipped to the 
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bounds of the view. When a window needs updating, it calls 
the virtual Draw() function for all the views in the update 
region. Within Draw() other functions are used to render 
graphics primitives, such as bitmaps, lines, shapes, and strings. 
Most of the user interface components in the Be system such as 
buttons, scrollbars, menus, and others are derived from BView, 
and handle drawing and mouse events automatically. 

There are many more classes in the Be application 
framework available to developers. The ones described above 
are simply die most fundamental to a Be application. They 
provide the basic functionality for an application that wants to 
launch and put up a window to do some drawing. Since die 
entire Be operating system is relatively small, il is easy for one 
person to understand it all. Il is also easy to learn and to get 
an application up and running quickly in the Re environment. 

Tnii Bouncing Bail 

Now let’s cut u> the chase and explore a sample application. It 
seems that every new computer platform comes with a 
bouncing-ball demo Bach platform uses this application to 
show something particular or unique about itself. The 
bouncing-ball demo on the BeBox, called Be Bounce, builds on 
this tradition - and add adds a unique twist. 

The Be Bounce application opens a small window that 
contains a single bouncing ball. The twist is that launching a 


second instance of the application opens a “gap" between the 
windows, the size and location being determined by their 
relative positions, and the ball is then able to bounce between 
ihe two “partner’' applications. As either window is moved 
around the screen, the gap between the windows follows die 
motion, growing larger or smaller and moving around each 
window r frame as dictated by Euclid G.e. by geometry). See 
Figure 2 ♦ If the hall happens to enter the gap it is magically 
teleported to die other application. 



Figure 2. The Be Bounce application 

In addition to showing some basic Interface Kit techniques, 
the BeBounce application demonstrates the straightforward way 
in which applications can communicate. As explained earlier, 
each Be application runs in its own address space and each 
window runs in a separate thread, Additionally, each 
application has a “main thread” represented by a 
BApplication object. The mu hi threaded nature of an 
application is inherited from the BLooper class. BLooper 
objects execute a message handling loop which responds to 
messages posted to the looper using its PostMessage 
function. The looper then dispatches those messages, in 
sequence, to ihe Target* BReceiver object by calling the 
virtual MessagoReceived junction. Note that BLooper is a 
kind of BReceiver so a looper can also receive messages. 

The BeBounce application consists mainly of one object 
derived from BApplication (TBounceApp), one object 
derived from BWindow (TWindow), one BMesscnger object, 
and one object derived directly from BLooper (TRa. 11). In 
the Be system, EMessage objects can be seni around within 
an application. However, to send messages between 
applications a RMessenger object is needed. The messenger 
object is a one-way connection between two applications. In 
BeBounce, when the ball enters the gap a message is sent to 
the partner using the messenger object, literally passing rhe 
ball to the partner. 
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creative partner who 
can expedite all or part 
of the development 
process for you. The SU5 Group has a track record of 
creating quality products, ready to publish and market. 


Making Your ideas Come Alive 

_ :su5 

PHONE: 817 /870-8557 

INTERNET: suftve©onramp net 

WORLD WIDE WEB: http://www.rahul.net/sufive/ 

MACINTOSH SOFTWARE DEVELOPMENT 


Let's take a look at some ctxle t starting with the mainO 

function; 

WIIn(Jnr &rgc t char* argv(J) 

I 

if to nmkHTH/r the mu valient nf the bouncing hall 

trand£ (InngJ *ya„tlM()); 

// nuke tile new application object and sun it running 

ay.app - new TBouncvAppt)i 
ny appORunO : 

// application h tmi>lvtd su ikainip ami return 

delate my app; 
return 0; 

I 


Itie basic idea is to create the application object and start 
ii running. The Kun (} function returns when the application 
quits. The TBounceApp object is then deleted and the 
program returns. Mom applications on the Ik Box will have a 
similar main () function 

The application object 

ITie BApplication object is the real launching point for 
most applications, and lie Bounce is no exception. Here is the 
definition of the TBouneeApp class: 


class TBoimceApp : 

public: 

public BApplication 1 

TBounceAppO : 

virtual 

"TBouncvAppU: 

virtual void 

Messiftefteceived (BMcssa jp. ; 

void 

TnitPartntr (thratd.id tid); 

void 

ReaovePirtnerU: 

bool 

SendToParttier (BHessase ’ug); 

bool 

Send Pos t t irm (IRect rect); 

private; 

TVtndow 

♦fkindow; 

HHpfiseng^r 

1 

*f Partner: 


The application constructor does several interesting things. 
First, when the application us launched it needs to determine 
how many instances of the Be Bounce application are already 
running. Here b a portion of that function: 

TBou nceApp:: TBounceApp (1 

; B App 1i c a t loft(HY_S1GkATURE) 

// (wh nr inrtiaJkaikMi code 


r 

lilt* veraon of BrtVmJKr i>nh support* 1 inMamc* of the appbratkm running zt 
il* same umc So if there air ilfoity 2 itAUuKr* miining force j QITT 7 

BList list: 

br roster-X^tTbrtsdUsttMT.SIGNATURR, Mist); 
long app_eount - Hat,Count ItesaU; 
tf 7ajtp_coutit >21 I 

// only Nippon 2 ippJkat*m> m j Urm 

Fo s ifta if su gc (QH T T _ R EQIJ ESTE D); 
return: 

I 


m if mem: mitialiraikiri In Ik- dtoCUffrtl hriciw 

\ 


The above code uses the be.roster {aka ‘rooster’) 
object, a system-wide object ihai, among other things, 
maintains information on all running applications. The rosier 
returns a list of all running applications that have the signature 
MY_SIGNATURE. If there are more than two instances of the 
application already running, this instance simply quits. 

If this is the first instance of the application it simply 
ensues the window: 

If [app rcumt “ 1) I 

//The first tratancc of UcBuumx will haw a ball 

fyindov * new TWtndovfvpoe* "Bouncing 1", TRUK); 

) else I 

// the second instance of Be Bounce 

I 


If there are two instances* livings are trickier: 

tf (app count 1) f 

,.. // the fina imancc 1 4 Bcttouncc 

\ else I 

// TTm »the second m^tantc U the licit *mtc app 

tVindov - new TWi nd«f{wpos, "Bouncing 2". FALSE): 

// determine which of ihr 2 imum rs r> mywti jihI whkh b ihc partner 

if tid b the "thread kT of mir partner* 

InitPafiner ftId): 
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Softwore 


Here. as before the application creates the window. It 
then determines the thread id of ius partner application and 
initializes a BMesganger object for communicating with the 
partner. The code that cremes thi* messenger is in the utility 
member function TBounccApp::lnitPartner(): 

void THouuuvApp:: Lftttf art Mr (tilt ®id id ttd) 

if (!! urtnoT W/im HELLO vmx condMon 

return: 

// c^uWiOi a ittracnftrf a* ihc link tocftir (wnikf 

fParTnor ~ new RWceaerigertMY_SlC* tid): 

\f (fPifiner >lrm() 1- mjEMOtt) i 
delete iTmiruft: 
n^r-.tior ‘ NULL: 

I 


it is important to note that this function handles the rate 
condition surrounding the BB_HEL.LO message. Imagine 
launching two instances of BeBounce at the same rime. The 
call to GetThreadLi si () could return two instances to each 


application. In this case Ixilh applications will behave as the 
second instance and btrth will send BB HELLO messages. This 
will result in TBounccApp: :Tn it Partner being called twice 
by each application. In this particular application the only 
result would be a small memory teak of the first BMessenger 
jbject. Understanding these types of race conditions is one of 
the critical aspects of designing software for the BeBox. Note 
that the code does not handle three applications launching 
simultaneously, In this case all three applications might decide 
that they are the “third wheel" and quit. 

After creating the messenger, the code constructs a 
BB_HELLO RMessage object. The next step is to add the 
thread id of this application to the message. The other 
application uses this data to construct its own FtMessenger. 
The window position Is also added to the message so that the 
partner knows this windows initial position, The message is 
sent using the utility function TRounceApp:: 
SendToPar tner. Other than error handling 
SendToPar trier contains just one line: 

Sonl TBoutiL a vAppr;$«GdTQF4rtti«r 

// rrnir hjiHlImp 

i Fart&er * >SeridKeseafc# (msgl: 

// tmjr lumlltni: 


Jam ary 1996 * MacTec :hMm; azink 


OpfiNiNCi rm BfRox 


33 










The final steps of the constructor are to create a "Stop Ball" 
menu item and show the window on screen: 

// imitk ihr TBmirKc App consmm 

r 

A Imk bu <4 menu codr Add a Slop Etatl menu item to the oppLcauun menu 
(found in the Dock window) Bv defouh tram in the “app* menu pusi meuagoto 
the applkauoti In thtt die the message should he "targeted' to the window, not 
the app 

7 

BPopUpKenu *aenu “ AppKftnuO; 

BHenultora ’lien * nmi &KeniaIte»(*StQp Bail 1 *, 
new BHeasage (BB_5T0P}* *V); 
item >SetTetj^vt (fUindow); 
a*mi->Addlt*»(it«)j 

f¥indow*>Shov(j ; 

it thin b the end of the ITJounecApp constructor 


The protocol that the applications use to communicate 
with each other is most apparent in the TBounceApp: : 
MessageReceived () member function: 

void TBounceAppf:H**tog^ftoceived IBtteesage *sasg) 

switch (asg’hfhst) I 
csss IB HELLO: 

//1 NCtimd BctknirKe Application b saving ftciio 1 

break; 

case UB„GOOUBYE: 

... //ourpartnermpuniitg 

break; 

esse BBJHNDOTJIOVED: 

.. // partner filmed, jjiJ lu* given us its new position 

broak; 

case BB_BALL; 

if we’vr just hern given the hall 

break: 

I 


Receiving a BB_HELLO message means that a second 
instance of the application is introducing itself. Here is the 
code for handling this message: 

can* BB HELLO: 

If (fU4ndow’)LeckO) I 

r 

A nrw instance of Re Bounce wai fust launched 
ami will us the minwhictorv message 

7 

Init Partner(mug >FJndLong("thread*)): 

ft Initialize our partner's current location 

pos - neg>FindReet("reet*); 
fWindow■> Pa r tne rMoved(pos): 

//Tell our new partner our mrrrni location 

pas - tWindow >Fra»* 0 ; 

SendPosltitm(pos); 
fVindowOUnioeki); 

1 

break; 


This code initializes a BMessenger using 
TBounceApp: : I nit Par trier {) and places the thread id in 
the message The partner's window position is also retrieved 
from the message and saved Finally' the code determines the 
position of its window and sends that to the partner The 
communication link herween the two applications is now open. 


The next message is BB_GOODBYE. This message is sent 
as Be Bounce applications quit. The code for responding to this 
message is quite simple: 

Cifie BB_ GOODBYE: 

if (fVindow*>UekU J I 
ft 0 «T partner » quilting 

EeiMJvePartntrU i 
if {osg->H*sloai<*ban*n 
f¥indow>AddBall(); 
fWindow >Unlock(): 

I 

break; 


The partner is removed using the function 
TBounceApp : ; ReosovePartner, the complement of the 
InitPartner function seen earlier. In addition, if the quitting 
partner currently had the ball a new ball is added to this 
application’s window: This ensures that there is always a 
bouncing ball. The code that sends the BB_G00DBYE message 
is described in the section on the window'. 

The final two messages sent between die applications, 
BB_WXNDQW_MQVED and BB_BALL* are status messages 
informing die partner that either the window moved or the hall 
lias moved through the gap. Here is the code, without further 
explanation: 

case BB_Wlbft>OW_HOVED: 

r 

Our partner b informing us that u moved This message h continually 

generated as the ulhcr window b being moved TWinckw PartnerMmed 

redraws the window to reflect the dew ptfeiUnn. 

7 

if tlkindow >LoekO) i 

pos * ■ag >FlndReet("reef); 
fVindov>PartnerMovedfpoa); 

fUindov-^UnlochO; 

I 

break; 

case BB_BALL: 

// Our partner just passed us the hail 

if (fVindow >LocktH f 

BPoint apesd - Mg->FindPoiat ( w ap«d w ): 
float rol jac * »Bg->FindFio«t(*rei_lm; ,, l; 
fVlndov >AddBall(rel loc. speed); 
fWindow >ttnl(Jck(); 

I 

break; 


The window' object 

The next class of interest is TWindow, a subclass of 
BWindow. In the BeBouncc application the window is 
responsible for managing the ball and for informing the partner 
application of particular events (see description of 
TBounceApp: :H#ssageRecei ved (} alxwe). Tlte window 
also presents tlie 171 for this application so there is some 
description of how applications can create and manage UI on 
the BeBox. in the Be operating system a BWindow object 
provides an area that tun display and retain rendered images, 
A BWindov by itself cannot draw, only BViews can draw. 
However, a BViev must belong to a window in order to draw. 
These rwo classes work hand in hand. 

Here Is a portion of the TWindow class definition: 
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When it comes to performance dtF is in a 
class all iLs own, dtF utilizes a proprietary 
query optimization anti caching scheme to 
obtain unparalleled performance. If you are 
in need of a quantum leap in performance! 
use the dtl*' naLive PowerPC stand-alone or 
client/server version. 


Full transaction control and automatic level-3 error 
recovery guarantee maximum data protection even after 
sudden system crashes, dtF databases are compressed and 
encrypted to protect against all unauthorized access, even 
disk editors* Implement sophisticated table and operation 
level security with dlF’s password features. 


*.dtF 


The Relational 
Database System 



Stand-alone 
applications built with 
dtF are royalty-free! 


...data security 


With dtF‘s unique direct integration technology, the dtF database system 
is fully contained in your application, enabling you to build double¬ 
click able database applications. Never worry about missing or conflicting 
INITs or drivers. dlF's native API is compact, easy-to-use and integrates 
seamlessly with all major development environments on the Macintosh. 
dtF’s high performance SQL, integrated data dictionary, security 
features, automatic index selection, query optimization and error 
recovery allow you to concentrate on creating great database applications 
instead of messing around with the internals of the database system. 


dtF is available for Macintosh System 7,x (68K and native PowerPC), 
dtF supports MPW C/C++, Symantec C/C++. Metrowerks Code Warrior 
(alt compilers 68K and native PPC). dtF is fully Open Doc™ compatible. 
Separate versions for use with HyperCard 2.x, SuperCard 2.x, Smalltalk- 
Agents and Pictorius Peregrine are provided. AppleScript interface via 
DaUiSeripl™ for dtF from General Knowledge, dtF supports cross- 
platform development on Windows 3,11, Windows 95 and OS/2. 


dtF Americas, Inc, 

19672 Stevens Creek Bfvd., 
Suite 128 

Cupertino, CA 95014 
USA 


Phone: (800) DTF-1790 

Fax: (510)828-8755 

AppleLink: DTF. AM ERICA 
1 n te me t: d tEamc rie a @ 

applelink.apple.com 
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PowerTap' 


Q: How do you make a Mac run your software 
10-20 times faster than it does now? 

A: Let it tap into a faster Mac! 

If you don’t believe it* send for a free test report* 
Belter yet, try our demo yourself* You won’t believe 
how easy it is either! 


• Easy-to-use API 

• Robust 

• Compatible 


• Supports PowerPC, 68K, 
A4 and Thread Manager 
software, 

* Supports une and 

mul ti-processor machines. 


Emerson Kennedy 





(800) 297-3888 

po we rta p <f® ao I. com 


PO Box 2530 • Redmond. WA <>8073 


class TWindo* : public BWindow I 
public: 

TWtndov (BRect frame, const char 'title, 
bool with ball); 

virtual -TVindovO; 


virtual 
vlrnml 
vii lUill 


void Hftiifiagojteccl ved (HKcssa^c *as|): 
boot QuitilcqueeiedO j 
void FrumeHovvd(BPoint new^position): 
void AddBailO; 

void AddBalHfloat tel_location t BFoint speed): 

// 4 fi w mure member fiuiokms 


private; 

void DravOffScreen(BVlow *v): 

// a couple more private member fimcikHis ami then 
// Mime private iluu members 


The TWindow coastructor contains several axle fragments 
worth discussing: 

TUindow;:TWindov(BRect frame. const char 'title, bool ball) 

: BtfindovH riffic, title. TITLED WTHDGW* M)T_RKSf7ARLR) 

I 

// Mime inltkili&lkm removed 

if (ball) 

AtfdBall H; 


r 

The drying takes plat e id the view IDflVkw I hat was added to the offscreen 
bitmap fBitrmp in tin* wav we'll Uo the drawing offscreen and then |ini blit rlie 
rmlt to the screen 
7 


fBitmap - new BBitmaptb. COLOR.0 BIT* TRUE): 
fOffVlew - new SVtevth. *\ 0, WILL DRAW); 

FB)tmap - >Lock O; 
f Ri t Bup >Adi{ChildUQ£fVicw); 

tlrmwOfTServon(fOlf View): it draw Lhe initial cocuenta offeacen 

£Bitmap >Unlock!); 

r 

Ibis vkw b added to the visible window Its imh mk b to blit the oibenom 
bitmap to the visible window, 

7 

fKainVlcw * now TB1 UimpViewfb, fBitnap): 

AddChild( fHitinView); 

// some initialization removed 


Here is the first look nr how windows and views are 
created and used on die Be Box, To gel smooth animation 
TWindow uses an offscreen bitmap (a BBiniaap object) and a 
basic BVlew object (TOffView) for the rendering. It is in the 
context of this view that all the actual drawing <x\nirs, TTie 
graphics primitives, like BVlew::FillRect() and 
BVlew: :FillArc() that create the effect of a ball bouncing 
off real walls* lakes place in this offscreen view. The last view- 
created, an instance of die TBi map View class, is simply the 
helper view that blits the hits from the offscreen bitmap into 
the onscreen window. Since the TBitmapView class (a 
subclass of BVlew) is so simple here is all its code: 

TBi TmapVtow: :TR I tnwpV lcw( BRmct frm, BBi Lump 'bitmap) 

; BVlcwtfranc. **. b'OLlOWjRJNL. W1LL_DKAW) 

I 

r 

lhe only job uf ihb view b lo blit the offscreen bits into the onscreen view, 

7 

'Bitmap ■ bitmap: 

I 

void TMi nap View:: OrawE BRect update) 

I 

// bill tfic bitmap with wiurvc and dot rrtfanjdc update 

DrewBitmapffBitraap, update, update): 

I 


As stated previously, a BWindow is a kind of BLooper, 
which in lurn is a kind of BReceiver, As such, a window 
runs in its own message loop and it can receive messages, A 
BView is also a kind of EReeeiver so it too can receive 
messages, A message posted to a window (using 
PostMessage) can Ik* “targeted* to either the window or a 
vfew c( i n t a i ned witht n t ha t w i nd ow. IJeea use of the connectio n 
between windows and views, a view typically receives 
messages in the context of its window. .Said another way, the 
handling of messages targeted to a view occurs in the window’s 
thread 

On Lhe Be Box, user actions on the keyboard and mouse 
are turned info BHessages, culled interface events. However, 
these messages are not handled by MessageReceivedf}, 
like the Be Bounce message BB_FTELL0. Instead, interface 
events are dispatched to u set of virtual functions 
corresponding to the action 11 ere are a few of those functions: 

BViov; :NouseDovmt) ft muuvcdown event m that view 

BView:: KeyDown {) // kcydnwn event while that view was 
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Gives you the Information to Program your Best ! 


The Debugger V2 
& MacNosy 

By Steve 'lasif 



Information 

T h© Debugger Is a low and high-level symbolic 
Debugger that runs in a full multi-window 
Macintosh environment. You can trace program exe 
culion, view the values of variables, etc of both 68K and 
PowerPC programs 

Mac No ay is a global interactive disassembler lhat 
enables one to recover the source rode of any Mac applica¬ 
tion, resource file or (he ROM. 

When you compare features of the different debuggers, 
note that only one has all the below features to help you get 
your job done, and only one has MacNosy to help you debug 
any program in a full system (6.Ox or System 7.x) environ¬ 
ment symbolically! 

It is the only debugger to use the MMU to protect your 
COOK resources and the rest of the system from the pro¬ 
gram you are debugging, With MMU Protection you can hud 
errors when they happen, not millions of instructions laterf 
[Macintoshs with 68030 CPUs only). 

The Debugger is die debugger of choice at: Adobe, 
Aldus, Claris. Electronic Arts. Kodak. Metrowerks, etc. 


wOm lPindouiRecord_@>465320 - . 

WindowFtecord /\ 

0 port 

CGra fPar t_@465320 m 

103 wmdowKind 

8 &i! 

110 visible 

TRUE S 

111 hfliled 

TRUE 

112 goRuiayF 1 c?g 

TRUE 

1 13 spareF1ag 

TRUE 

114 strucRgn 

^Reg ior^488974 

118 contRgn 

‘"ftegionJF485534 “ 

122 updateRgn 

* * Region_£4859B0 m 

126 wirdouuDefProc 

* * OEF funRsrc_P8768F0 

130 do taHond1e 

8485970 

134 till©Handle 

€■4859 18 = "Unit tled-l” M 

138 UtJeWidth 

67 if 

140 Control List 

NIL 

J44 nextUi ndotw 

*U indowRecordJ?465278 

J48 uundouiPic 

NIL 2 

152 refCon 

400464F28 £ 


An example of a structured data display window 


Its Features Include: 

• Symbolic Debugging of any Macintosh program, ROM, or 
code resource fDRVRs. XCMDs, INITs, PDEFs, 4DEXs „) 

• Source level debugging for Metrowerks & MPW compiled 
programs (C++. C, Pascal Fortran, ...), and an Incremental 
Build System with Instant link for superfast development. 

• Object Inspector for MacApp 3 programs 

• Source level debugging of Think C™ projects 

• Includes a program (CoverTest) to interactively do Code 
Coverage analysis for SQA testing, etc. 

• Simultaneous Symbolic debugging of multiple "tasks” 

• Fast Software Watchpoint command to find clobbered 
variables 

• Sophisticated error check algorithms such as Trap 
Discipline (Argument Checking), Handle Zapping, Heap 
Scramble and I leap Check to detect program errors before 
they become disasters 

• Structured display of data (hypertext) with user definable 
structures while debugging 

• Conditional breakpoints to help Qltcr out redundant 
information 

• Continuous Animated Step Mode to watch your program 
execute Instruction by instruction 

• Detailed symbolic disassembly for both 680x0 and 
PowerPC uith symbol names, labels, cross ref maps, - 
make It possible to ferret out Uric secrets of the ROM, etc. 

• "Training Wheels" for the PowerPC disassembler to help 
you learn the opcodes 

The Debugger Y2 & MacNosy: $350 

Runs on ail Macs, Call For Group prices or Updates. 
Visa/MC Accepted 

Available from: Jasik, APDA. Frameworks or 
ComputerWare (800-326-0092). 


Jasik Designs • 343 Trenton Way, Menlo Park. California 94023 • (415) 322-1386 

Internet: macnosy@jasik.com • Applelink: D1037 




















You Can't Wait Forever. 


Let's Face It 

As a professional developer or webmaster, 
you have to think of yourself first. You have 
deadlines to meet products to deliver, and 
people depending on you. 

A Tool in Hand*,. 

Your tools are your livelihood. You need up- 
to-date technologies and timely support. You 
can't afford to wait for vaporware to material¬ 
ize or for your tools vendor to leisurely add 
features that you need today. 

When Hell Freezes Over? 

When was your text editor last updated? Six 
months? A year? Five years? And when you 
contact the vendor that produced it, do they 
toll you how they're working on the next great 
version, how wonderful it's going to be, and 
how it will ship "Real Soon Mow"? Or worse 
yet, do you get a disconnected phone number? 

That's where we come in. 

At Bare Bones Software, we deliver the best 
tools here and now. We have a distinguished 
tradition of con tin unity enhancing the hmetion- 
ality, performance, and design of our products 
to meet our customers' needs. We don't allow 
our products to languish until we feel like doing 
something about it. We won't hype vaporware 
as the solution to today's problems. And we 
haven't drifted in and out business on a whim. 
We're here to support you foT the long haul. 


What About the Software? 

You don't have to wait for the software, either. 
We're constantly refining our techniques and 
technology to bring you the fastest and most 
efficient tools. As the result of our efforts, 

BBEdit has repeatedly raised the standard for 
Macintosh text editing. (In fact, we've done so 
many cool things, several of our competitors 
have tried to copy us. imitation is the sinccrcst 
form of flattery, after all. We're very flattered.) 

Why Believe Lis? 

Since its commercial debut in 1993, BBEdit has 
set the pace for capability, user-in terface, 
functionality, and customer support that others 
have yet to match. BBEdit was the first text 
editor to support ToolServcr, THINK Reference, 
Toolbox Assistant, THINK C/Symantec C++, 
Internet Config, Quickdraw GX printing, 
PowerTalk, PowerPC acceleration, AppleScript, 
Apple Guide, and Macintosh Drag and Drop. 
We're still setting the pace for others to follow, 
as the only Macintosh text editor to integrate 
directly with Metrowerks CodeWamor, through 
the use of the Click Warrior extension. 

See for Yourself. 

We've painted a great picture, but don't take 
our word for it. Visit our Web site and see for 
yourself. You'll find lots of things to like. 

BBEdit. Because you 
can't wait forever. 
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Clean Up Your Act. 


Introducing SoftPolish. 

SoftPolish is a quality assurance tool that 
helps you deliver applications that are clean, 
consistent, and free from spelling and user- 
interface mistakes. 

End Embarrassing Odor and Wetness, 

Apply SoftPolish to your product's resource 
file (or built application). SoftPolish checks file 
integrity, scans the application signature, menu 
and 'emnu' resources, controls, dialog items, 
pictures, strings, 'TEXT' resources, windows, 
and Balloon Help 11 * resources. It reports any 
structural, spelling or typographical errors that 
it encounters. SoftPolish also checks the layout 
of dialogs and controls to make sure that items 
don't overlap. At your request, SoftPolish will 
also correct spelling mistakes, so you'll never 
again ship a product with embarrassing typos. 


Put on a Pretty Face, 

When preparing your product for release, 
use SoftPolish to ensure a perfect presentation 
to the world: it deans up unwanted resources 
in your files (such as extraneous 'SIZE' and 
'ckid' resources), sets creation and modification 
dates to a consistent value, and checks the 
spelling of file and folder names. After ail, your 
customers don't really need to know that the 
product was built at 4:30 AJV1 on the day after 
you announced... Do they? 

A Software Mine Sweeper. 

When applied to a 68K application, SoftPolish 
also catches code that you wouldn't want your 
customers to see: Debugger and Debugs tr 
calls, CHK and TRAPV exceptions, and Macsbug 
symbol names. 


SoftPolish. The Essential Tool for Software Quality. 

Visit our Web site or contact us for more information about SoftPolish and our other fine products. 

Something for nothing* Although our commercial products have won critical acclaim and popular 
support worldwide, we've also built a reputation for producing free software that exceeds the quality 
standards of many commercial products. 


BBEdit Life The freeware cousin to our 
award-winning text editor. Used and loved 
by countless people worldwide. 

Drop*PS Sends PostScript 1 * or EPS files to 
any network-connected PostScript printer. 


PopupFuncs Adds source-code navigation abilities 
to any PopupFuncs-aware text editor or integrated 
programming environment (including MPW, 
Symantec C++ and Metrowerks CodcWarrior). 
Enables you to browse C, C++, Pascal, 68K 
Assembler, Rez, and FORTRAN source files. 



Bare Bones 

S O ( I w J f f * I n t 


Bare Bones Software, Inc. 
P.O. Box 1048 
Bedford, MA 01730-1048 
USA 

Voice: (508) 651-3561 
Fax: (508) 651-7584 


E-mail: bbsw@nctcom.com 

Web: h ttp://ww w. tiac.net/biz /bbsw / 

FTP: ftp:// ftp.std.com / vendors / bbsw / 

ftp://ftp.netcom.com/piib/bb/bbsw/ 

Our goodies can also be found at many popular sites, 
including the file libraries of AOL, CIS and eWorld. 


Our lawyers insist we say BBEdit* BBEdit Lite. rtipuprurtcs, SoftPolish, Drop*PS and nur t v lojju are [r.tderruirlks of Bare Both** Software., Inc Mot: and the MatOS ki£u 
itnr trademark c# Apple Computer, Lite., used under license PowerPC is a trademark of htieni/tEkinal Busmen Modumy Corporation All other trademarks and registered 
trademarks are properties of their respective holders. Rare Ikmes Software, Inc. product* are cruelly free (ewept for a Frw beta teshm). O Bare Bonr* Software,, Inc. 















POSITI ONS WANT bW _ 

Tva.hbU 1—dirib MWO-736-3577 

Expert 4D Programmers 
Less than 50e per hour! 

More than 1,000 Lours of development _w*nc ii«to 
4 D Toolkit 2.0. With a one tune price ot *W ul) * 
£ 1 hiring a crack team of“ 
less than 5<>< per hour. Call 1-800-73 
order your copy, of to receive a free 


4d t o o lIk I T 


OPrmn* Computer Con&iilrmj; 
228l)kctkcr Street *19 
NVw York, NY 10014 
itu 2124545-3577 
PAX: 212-633-0336 

• t/p^de prtimx arviUlU 



If the 'fcxirscd' view 

BV1 1 - w:: Fra a<‘ H i* a lied // the view changed m/v 

HW: > : .iv; : r ^ M • (i // the winjuw fHaitiun moved 

BWinciou :: (Ju ix Kf quftfftftd t // dfcfc on dcae-box of window 


It turns out that in lie Bounce only two interface events arc 
of interest, the FrameMoved and Qui tRequesled events. 
The system repeatedly generates the FrameMoved event us a 
window is being dragged, This event is of interest because as 
ihe window moves, so should the gap that exists between die 
partner windows. Here is the code for responding lo (he 
FrameMoved event; 

void TWindow: :f rameHovedfEPoint new po£) 

f 

r 

As window i> mov ed an Kind the senmt vrc mfoma onr 
partner dt our nrw h h alum Abo liptUit* anr lyp 

V 

fHyFi unu » FraatO: 

if l*y_app->SendPositiontfHyfrsiie)) 

Vi ndovsltoved {fMyF t aae. ffartnerFrme}; 

I 

lilts axle gets the window s current location and sends it 
to our partner so that our partner can update its gup 
TBounceAf)p:;SendPosjtion() sends the RB_WlNDOW_MOVED 
message to the partner (see the code m 
TBounceApp: :Message&eceivedQ for the code that 
handles this message). Only if we have a partner will 


TBounceApp: :f)endPos i tionO return TRUE. In this case 
the code calls the TWindow::WindovsMoved (} function, 
updating this window's gap. As BeBounce windows move 
about the screen everything is kept in synch. 

Tile tidier event of interest is generated when the user dicks 
on the dose box of the window. In BeBounce closing die 
window should also anise the application to quit. This means 
llial the window has to listen for the Quit Requested event: 

bool Ttflrtdcrv:; Quit Request wU) 

r 

Hie window was asked Lu qull/dmc Stud .1 to our partner, giving I urn 

the ball If wc’vc uirnrntlv It. 

V 

BHessage *tn - nev BHpnnsp.pfBa GOODBYE); 

If ffBfllU I 
fBJil l >quit.U: 
fRat 1 * NUUs 
» >AddBo<»l(-bi*lI-, TRUE) \ 

1 

ra Y^*PP')SeftdToPartner(n); 

// Tdl Lite 4|ip to jin ahead Jtul quit 

■y app->PantMenimg*{QiITT REQUESTED); 

return TRUK; 


Hie Mrst thing to do when the QUTT_EBQUESTED message 
is received is to tell our partner good-bye, passing the ball 
along if it is in our possession. It would not l*e polite to quit 
with hall in hand. Please note that the TBounceApp: : 
SendToPartner() does the correct thing if there is no 
partner. Next the window posts a message to the application 
telling it to quit as well. The return value t>f TRUE causes to 
window to immediately quit. 

The bal l 

The Iasi object to describe is the ball. Several factors 
influenced the design of the ball. It is desirable (u keep the 
ball independent from the window, yet they still need to 
communicate with each other Also, the ball periodically 


requires lime to 

simulate motion. One design that 

a ccom m i >da les t lies 

u guidelines is to construct a subclass of 

BLooper called Tftal 1, This means that the ball has its own 
thread and il is able to receive messages. Here is pan of the 

class definition: 


class TBall : public BLoopet 1 

public: 

TBaI UTWlndtHt *vlntlow, flftcct bounds, 


ftPoiut center, flout radius, 
BFoini speed); 

void 

DraidBYiav “view); 

virtual void 

Kesea(teReeatvod (EMessa&e '*$&}; 

void 

LockO: 

void 

tinlurkO ; 

void 

SelGapUlout tfiart, float end); 

void 

SutEnabled(bool state}; 

ft a tropic other riK-inhrr him i ion* 

private; 


void 

Next Foe ition(hool *biT. float ‘angle); 

void 

tick 0 1 
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FREE INSTALLER! 

To: Mac Developers & Product Managers 

From: MindVision (Co-authors of Speed Doubler) 

Subject: Free Copy of DEVELOPER VISE 

Message: We've got a great new installer for you. 
Here's your chance to try it for free. 

No risk, no obligation, no hassle. 

Call today, don't delay! 
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INTERNET SALES@MtNDVISION.COM • APPLELINK, A0L; MINDVISION • COMPUSERVE 70253,1437 



Join the growing list of companies who use our VISE technology: Adobe America Onl ine, Apple. Claris. 
CompuServe, Commix, Intuit, MacmMedia. Netscape, Symantec. WordPerfect, anti hundreds others. 


MindVision Software 840 South 30 th St, t Suite C. Uncoln, Nebraska 68510 
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BLocker fLock; 

TVJndcw * ftMndov; 

... // a hunch of data membra for *sc*te‘ Kkc swc 
// vpcttl/dtiraion. po*nwi r etc 

1; 


Having a thread per ball would not scale to an application 
that had 1000 bouncing balls, but for demonstration purposes it 
works well. 

Most of the constructor for the TBall class is fairly simple, 
initializing the various data members, The most interesting 
aspect of the constructor is that it starts the looper thread 
running and posts the first BE TICK message to get the 
animation working: 

TBall; iTBaU (TWiadov ‘window, Bftect bounds, BFoint center, 
float radius, BFoint speed) 

: fLock0 

I 

... // inriult/r parameters tike size, location, ami speed 

r 

Get the looper thread rolling l alike ihe rati 10 HApplicuiim Run, which docs riot 
return, Tin* call n> return. 

7 

Run t): 

// post tnittal message to gn animat Km gmng 

PoetHeesagc*(BB„TICK); 


The TBa l I's MessageReceived function handles the 
BBjriCK message: 

void Tflall: :Mp!I sage Received(Message *nsg) 

I 

switch fmsg >whet) ( 
case BB.TICK: 

LockO; 

Tlckf); 

UalaekO; 

« // sleep for j liitlr bit of lime 

// (Kisl next message to continue animation 

PotftHessagef BBjnOO: 
break; 

I 

\ 


The LockO and Unlock () calls shown above deserve 
further explanation. The BeBounce application was designed 
so that the window' "communicates* with the hall not by 
posting messages to it, hut by calling specific member 
functions; see the definition of the TBall class. For example, 
one of those functions is TBa 11;: S et Gap {): 

void TBall::Set Cap{float ttart. float end) 

I 

Lock(); 

fGapStart * start; 
fGapEnd “ end; 

UnlocfcO; 


A consequence of this design is that two separate threads 
access the same data structure, so some form of 
synchronisation is required. The BLocker (also known as 


“blocker”) class provides this synchronization. Imagine if the 
locking was not present Then in the middle of the looper 
thread's calculation to determine if the ball hit that gap the 
window thread could come along and change the gap. This 
would lead to undefined behavior Code in TBounceApp:; 
HessageRecelved () locks the window 7 for this same reason. 

An alternate design would have the window sending 
messages to the ball. In this case, locking would not be an 
issue, The act of posting messages implicitly provides the 
synchronization needed. The balls looper thread cun only 
handle one message at a time. In this example the trade-off 
might be the latency of messages changing the “gap” position 
or starting and stopping the ball, with the Stop Ball menu 
item, 'ihe preferred method should be determined an u case 
by case basis. For educational purposes the Be Bon nee 
application uses both styles of programming. 

Back to the BB TICK message. Most of the work in 
animating the ball is done in TBall: ;Tick() f and most of 
that code is the mailt and geometry needed to animate the 
bouncing ball and determine w hen the frail cither hits a wall or 
flies through the gap. As little of this code is specific to the 
Be Box w r e will not go into any more detail except to show- how 
the bull draw's. 

void TBall;iTick() 
l 

// move bill to new p<ttiti<in 

// Intern Lbe window to redraw llie window 

BHessagt *asg * new BMessageIBB_DRAW); 

sag*>AddRect("update", upditteRerr): 

fVindov^pQEttofiflsagefmfig); 

If Chit_hole) ( 

r 

The pap was hit So wc package up the info like speed and relative location. 

which give* our partner enough mfomuuun to have the hall appear in the 

eormt place 

V 

BH&Jsa&ge *mfig * rwu RH>fifli*£e(RR_flfT,Jt0LE); 

... // adding info m message 

fWindow >PoatHes^ogc(ifiag); 

I 

Tlie TBall: :Tick() function moves the trail to the next 
position and then posts a message to the window telling it to 
redraw Itself. Additionally; if the ball hits the “gap M a 
BB HIT HOLE message Is posted to the window: 

When the window receives the BB DRAW message (in its 
MessageRece i ved function) it asks the ball to draw' itself in 
its current location. The drawing is done by TBall: : Draw (): 

void TBaIt:;Draw(BV tew ’vie*) 

// The hath dnm> itself in the given view 

LockO: 

rgb^eolor e ■ view->FrnntCoior(); 

vlev'>SetPenSize(1.0); 

view >SetFrontCnlot(ISO, IQ, 10); 

vlev'>FniArc(fCenter« fRadius, fRadius. 0.0. 360.0): 

view >SetFroiuColor(c): 

Unlock () j 

1 
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* QDBBE3I 


‘Draw and verify your design, generate code or reengineer existing code Bad^to diagrams. 



OOA/OOD includes GMT. Booch 94. Coad/Yotmbn. Shher/Melhr. 
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Data modeling and SQL generation for Information Engineerings Chen. . 

MacAnalyst 

& 

MacDesigner 


Software Engineering 

Structured Analysis & Design 
Object-Oriented Analysts 8l Design 
Real-Time & Multi-Task Design 
Dam & Screen Modeling 
Integrated Code Editing & Browsing 
Mulii-User Dictionary & Requirements 
Code to Design for C++, Pascal Fortran.., 
Design to Code Tor C-H-, Pascal. Fortran..- 



New in Version 5.0 

Jacobson. Fusion, Use 
Cases, Harei Statechans, 
Interaction Diagrams and more 




Products are available by single, site or 
educational license and supported with on-site 
training, update service, free newsletter and 
technical phone support. Products include 
sample documents, tutorials and online help. 

Product Options 


MacAmifyst 

$ 995 

MacAnatyst/Expcrt 

$1595 

MacDesigner 

$ 995 

MacDcsigncr/Lxpcrf 

$1595 

MacA&D 

$2995 

Translator 

$ 495 



System Requirements 

_Macimosh System 7 with 8 meg RAM or 
UNIX with Apple's MAE software. 
Winner of the 1994 CIO Magazine 
Readers' Choice Award, MacAnalyst 
and MacDesigner are used by thousands of 
developers worldw ide for personal computer, 
mainframe and embedded software projects. 

Call now for free technical brochures! 


Excel Software 

515-752-5359 

RO. Box 1414 • Marshalltown. IA 50158 
cascLooIS@flt)l,Com * Fax: 515-752-2435 

MacAnalysL. MacOcsigner, MacA&D and Tran si at or 
are trademarks of Excel Software. All rights reserved. 




































































































































Quality: 

Compatibility 
Bug Reporting 
Test Plans & Suites 
Regression 
Metrics 

Engineering: 

Design 
Development 
Code Reviews 
Debugging 
Analysis 


22 tears of 
Macintosh 
Experience 


"Quality Development" 


14 Vears 
Experience at 
Apple 



Apple PowerLabs Engineering 

Computer 975 Town & Country San Jose, CA 95128 & Quality 

Partners (408) 24-POWER Assurance 


Hardware: 

PCMCIA cards 
MacOS Clones 
PCI/NuBus cards 
Modems 
Printers 

Software: 

Drivers 
Applications 
CD-ROM Titles 
Extensions 
Utilities 


The view passed to TBall: :Draw() is the same view 
that was added to the offscreen bitmap in the TWindow’s 
constructor, so the ball is being dniwn offscreen, the window 1 
then gets the TBitmapView (described earlier) to blit the 
offscreen image onto the screen. 

The code for handling the RB_HIT__HOLE message is in 
TWindow: iMcsttageReceived: 

void TWindow; iMe&gftgftRfH-.rOvtttf (BMessage *gisg) 

Evirrh >wtinc) ( 

ram* BUUTJlOLEt 

r 

!Tk lull is ictteig us i Jtiii li \um hit the 
tmfcr Sii H tltuuJd jati H'tit to ibc partner 
7 

BHoccagc 'a - RW^rtfiaerdfllLBALU i 

fB a 1 WLnrkO * 

■ >AcSdfflt nr (*npccd B , nsg >i 7 indPpiiJtt ■speed*)); 

* >Adi!Klu,ji Msg >FladFi0atfreI_ioc*)); 

m«U >m\ockUt 

// send ilk- hall ui our partner 

ay_ipp ‘ >Sf rwJToPa r ta*r f m) i 

ft drlrtr the hall fmm this window 

fB4lt >Qult(); 
raall - HULL; 

if redraw the wlmkrw 

UpdateU: 
break: 


... //lundling uf nthcr <ikr\ugr* 

I 

I 

The window responds to the BB HIT_HGLE message by 
sending the BR_BALI, message to the partner application giving 
it the hall. It puts die necessary information into the message 
so that the partner can create the new ball in the correct 
position, with the correct speed and direction. Finally, the 
window deletes the ball. 

That is how the UeBounce application works. Obvious 
improvements to He Bounce would be to support more than 
two applications, multiple windows within the same 
application, and multiple balls. Another useful addition would 
lx a separate control window with some controls for tilings 
like ball sfxed, All of these enhancements are feasible given 
the design of the Be operating system. To support an arbitrary 
number of applications each application would maintain a list 
of partners, having a BMessenger object to each one. 
Multiple balls in a window could cither communicate with one 
another (for hit testing purposes) directly or use die window 
object as tlx arbitrator. 

Hopefully this sample application luis provided a taste of 
developing an application for the 13eBox. The next question is: 
How do Be applications get built? 
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At ICONIX, we have a 10 year record of being 2 years ahead of the industry. Since 1985. we have maintained the 
foresight to consistently create products 2 years ahead of our competition. This year, we've done it again... 


* 1995 - Maintaining Tiie standard of exceUence set by our popular "Object Methodology Overview", our 
new "Unified Object Modeling Approach" training CD ROM combines the best elements of Rumbaugh, 
Booch, and Jacobson methods, with prototyping, for full lifecycle modeling from requirements to code 
generation. And now, ICONIX makes its full suite of PowerTools^ available for the PC platform! 

PowerTools are now available for DOS, Windows 95, Windows HT, Windows 3.1, OS/2, Mac, 
NextStep, SunOS, Solaris, HP-UX, SGI IRIX, AIX. Alpha and Linux! 

* 1994 - ICONIX eliminates the "industry standard" UNIX price markup with our "one price - all platforms ' 
MOTIF releases for UNIX. Our SQA enhancements give users the ability to associate Requirements, Test 
Cases, Bug Reports, and Change Requests with class, object, and use case models 

* 1993 - Complete support for integrated Booch, Rumbaugh, Jacobson, and Coad/Yourdon models, 

* 1992 - Addition of OMT support, and Integrated Requirements Traceability 

* 1991 ■ Initial Support tor QOA and ODD using Booch and Coad/Yourdon melhods. 

* 1989 - Support for Ada/QOD gets added to our existing real-time, structured CASE tools. 

* 1987 - We add multiuser capability to our tods t in support of large programs such as the Space Station. 

* 1985 - ICONIX pioneers easy to use. low cost, GUI-based CASE lools on the Macintosh, 



See The Future... 


You can wait 2 years and get left behind with our competition...or see the future NOW: 

Visit us on the Web: http://wviw.biap.com/iconix/, call us at 310458-0092, or email iconix@ewortd.com 


M ICON IX 

Leadership in Object Technology™ 


Development Tools 

You write applications for the Be environment using tools 
supplied by one of the leading tool suppliers in the industry - 
Metrowerks. Currently the preferred development environment 
is a Macintosh with the latest version of CodcWanior and Be- 
sup plied headers and libraries. Using Code Warrior on the 
Macintosh, a developer can write, compile, and link a Be 
application. Of course, you have to transfer the application to 
the Be Box before it will run. Since the Be Box supports ftp and 
includes a command-line shell (based on bash) the process of 
quitting your app, bringing over a new one from the 
Macintosh, and running it on the BeBox can be completely 
automated. There is also support for using the source-level 
debugger on the Macintosh to debug an application while it is 
ninning on the BeBox. Metro werks is currently working on a 
port of the full Code Warrior Integrated Development 
Environment to the Be operating system. This native version of 
Code Warrior, along with full technical developer 
documentation, will be shipped with every BeBox. 

Conclusion 

This is just a small taste of the BeBox. We have presented an 
overview of the Be operating system along with some sample 
code to give you the general feel of Be application 


development. To learn more about the Be operating system, 
please visit our web site, where we provide on-line versions of 
our developer documentation as well as information about our 
product and company, We encourage developers interested in 
joining our support program to mail in the developer form, 
which you can find on the web site. 

Be hits many plans for the future. We are continuing to 
improve and add features to the Be operating system and 
development tools, We are also working on future versions of 
the BeBox t which will include more and faster processors - 
including a machine with four PowerPC 604 chips lor the 
horsepower hungry. 

We hope this article has succeeded in whetting your 
appetite for Be programming. We look forward to seeing all 
the incredible applications we know' developers will write for 
the BeBox. ^ 


Visit MacTech Magazine’s Web site! 

http://www.mactech.conn 


January 1996 * MacTeoiMagazine 
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SYMANTEC 
TOP 10 


By Michael Hopkins, Symantec 


SYMANTEC. 


This monthly column, 
written by Symantec’s 
Technical Support 
Engineers, aims 
to provide you with 
technical information 
based on the use of 
Symantec products. 


Q: I want to be able to add files to my 
project, such as ReadMe files and 
notes, without having the project 
manager attempt to compile them- Is 
there any way to create an extension 
such as a .note extension in the 
SPM that does not use a translator? 

A: Yes, there Is. Quit the SPM and open 
your Symantec C++ folder Copy the 
file cnone* front your Translators 
folder (the one with the THINK 
Project Manager icon) to your 
(Translators) folder (the one with 
rlie Symantec Project Manager icon). 
With ResEdii, open the copy and 
choose Get info for «none» from 
the File menu* Change die creator 
from KAHL to None. Save the file, 
and quit ResEdit. Now go back and 
launch your project in the Symantec 
Project Manager and choose 
Options.,, from the Project menu 
and go to the Extensions page. 
Type the name of the extension lhat 
you want to use for your non- 
compiled source files in the File 
Extension edit text box. Choose 
< none » from the Translator 
popup menu, click the Bdcft button 
and then dick the Saue button. 



Addin# note to the File Extensions IJst 


Q: When I run my program with the Symantec Debugger horn 
the Symantec Project Manager, the source code window 
does not come up and the debugger palette buttons Go. 
Step. In, etc are not active. What is causing this, and how 
can I fix it? 

A: This behavior is a result of your application being compiled 
with incorrect 'SIZE 1 flags. The debugger requires that 
your project has Background Null Euents and 
MultiFinder Aware checked on the Flags popup menu 
in the Project Type page of the Project Options dialog. 
Without these flags, Power Mac DebugServIccs will not lie 
able to communicate with yoitr application. 


Q: 1 have written ;s brief program in the THINK Project 
Manager that is crashing my machine big time. The code is 
as follows; 

typedef struct I 
Int a, b; 
t Fao, 'PoftPtr; 

ftuiiiO 

FooPtr foobuti 
int i* size *- 100: 

fo&btif - (FooFtrJ malloct sise’sizeof(Feo) ): 

If (fnobnf ** NULL) 
exit (Oh 

foe ( 1 - 0: i i Size: i++ } 

t 

foobuftlj . a = 0: 
foobuf.b ‘ 0; 
t 
I 
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Why is this causing me so much trouble? Is something 
wrong with malloc? 

A: No, tnalloc is not at fault. By not including <stdio*h> 
and <stdlib.h> 1 your compiler does not have a function 
prototype for malloc, so it is guessing (incorrectly) about 
the size of the argument to malloc. Instead of using the 
type size_t, it is assuming an int. To avoid this 
problem, always choose Require Prototypes on the 
Language Settings page of your THINK C Options 
dialog. With that option selected, this would have resulted 
in a compilation error instead of a runtime error, 

Q: Can I use Quickdraw GX with TCL and VA? 


A: Yes, it is possible. For starters, initialize Quickdraw GX in 
CApp: : ICApp () in the following manner; 

void CAppr:ICApp () 
f 

Ix„CApp(A, 24000L. 2Q480L. 20^8L)s 

// Initialize your own application data here. 

long graphicsIleapSize ■ J/S; //ahuut25X 

theGXClient * CXHevGraphicsCiient{ nil. gGraphicsHeapSize * 
1024L. 0L ): 

FailNIL' th#GXCli«nt ); 

GXEnt e rGr a ph1c s(): 

assert (GXGetGraphicsError t nil I 1“ out_of_n™ory): 

//etc 

\ 

You will need to declare theGXClient as a member function 
of CApp of type gxGraphicsCl lent and include die proper 
header files in CApp.cp, Additionally, it Ls a g<xxJ idea to 
override CApplication:; InspectSystemO to check for 
the presence of QuickDraw GX it Ls considered programmer 
error to call GX routines without verifying via Gestalt () that 
GX Ls present. Finally, override CApp li cat ion: :Exit () in 
CApp using the following example: 

void CApp; :Kxit( ) 

GXExi t Graphics {)j 

ta3li«poifl6raphin*Clifint( cnyGXC 11 pnt }; 

//etc... 

x_GApp: 

\ 


Q: Why does printf crash when I use it in a TCL project? Is 
there any way to use TCL in conjunction with the console? 

A: Yes, there is. The console package does some special 
initialization tlut needs to lie done in place of the standard 
toolbox initialization that TCL does. To use die console with 
TO., you should override CApplication: : InitToolboxO, 
like dtb: 

void CApp;: TnitToolboxt void ) 

I 

cout« rt Initialize console package"«endl; 


The call to cout in place of the standard 
CApplication; ;InltToolbox() will initialize the 
toolbox and the console package. This will enable die use 
of printf and iostreams routines with the console 
window. Note: You will need to add the IQStreams 
library and replace ANSI_smaIl with ANSI. 


Q: How do I make an application (or the Project Manager) 
multi-session, so I can throw- it on a server and have several 
users run the application off of the server at the same time? 


A: Use KesEdir to open the application you want to share. 
From the File menu, choose Get File Info for the 
application, and click the Sharable flag. Saue the 
application, and Quit KesEdit. Your application can now 
lx? used by multiple users simultaneously. 


Q: l am working on an application that prompts the user for a 
password. 1 need to be able to filter the edit text so that it 
displays bullet characters instead of die actual password. Is 
there an easy way to do this in VA? 




Enter the Secret Password: 


f --- \ 


Example of an Application that uses a Password Edit Text Filter 


A: Yes. You must first create a derived class from CDialogText 
in VA. Then override the DoKeyDownO method in the 
following manner: 

Void cPiiEfgwordText: :UuKeyDowu[ char tbeChar, Byte keyCode. 
EventRecord * macEvent ) 

I 

Boolean pass - TRUE: 
abort ID: 

Str25S textStrlng; 

switch (LheChur) 

( 

esse TCL^CR: 
case *\%*; 
case klnterKey: 
pass - FALSE: 
break; 

case kFiScepeOrClear; 

if EkeyCode KeyEscape) pass - FALSE; 

break; 
default: 

CetTextStringl textString ); 

if C ! isalnumC theChar )) // pa,ss spaces ami delete kevx 

t 

inhflrited: :DoKeyDcvn( theChar. keyCode, mdcKvcni ); 
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MacForth Plus & ^ 
Power MacForth 


The Language of Innovation is now 
available native on the Power Macintosh , 


FEATURES 

» Royalty Free Turnkey 
Compiler 

■ Text Editor 

■ Online Glossary Tool 

a System 7 Compatibility 
a 68020 Assembler 
a 68881/2 Co-processor 
Support 


■ Fligti Level Graphics 

■ Toolbox Support 

a Extensive Documentation 
a Reasonable Upgrades 
a Optional Tools Disks 
a MacForth Plus $199 
a Power MacForth $199 



CreAllv* SotktUMnA, Ftv^. 


4701 Randolph Road, Suite 12 
Rockvict. MO 20852 

301-9M-Q262 or 1-800-FQFTTH-0K f ordm) 
Fa*: 301 -770-1675 AppfeM: CSI 


jjoss " false; 

l 

1 

if (pass) 

I 

textSrringfOlI\; 

textSl r irtf, tPxtJ>U ItigfO] ] ” 

SutToxtSt Hngt L cut St ring ); 

// .idd code to sturt nciual characters typed here 

if [itsTypin^THsk hk IteTypingTask->CanStiXiType()) 
f 

ID * thii-HDi 

Iroiiflc is^ttChange(HtalogTextChanged t ME); 

I 

t 

else 

itaSupervisor*>DoKeyDown(trieChar t keyCode, macEventJ: 


A: When you use our Universal Headers, you need to make 
sure that you have ihe proper uses statements for the 
toolbox routines that you are using. You can no longer rely 
on the correct uses Ixnng used automatically. You will 
need to lx* very conscious of which interlace file you use. 
See the Readme for further details. 

Q: t call the Placed method of a CPanorama object I have 
created in the Main view using VA, but nothing happens. 
Placet) works fine for other objects derdved from 
CPane. What given? 

A: Place () , inherited from CPane, sets Lite daLa members 
hEncl and vEnel, which indicate the pane's position 
relative to itsEnclosure, In the case of CIconButton, 
for Instance, itsEncInsure will be the itsMainPane 
member of the Document (itsMainPane is the 
CPanorama object that acts as the background of every 
view of type Main Window). Hence, calling tire Placet) 
member of a CIconButton visibly moves the button 
relative to the window. In the case of a CPanorama object 
however, itsEn c1osu re Is actually itsScro 11 Pane, A 
panoramas Placet) function will not visibly change its 
postion. You should instead call it s Sc roll Pane * > 
Place () to move a panorama relative to the window. 


If you have a question or topic for a future Top Ten article* 
please send us your ideas. If you have found an answer to an 
obscure problem that has been eluding you, or you have a 
stumper, send it to topten@devtools.symantec.com. If we 
choose to use your question in our column, your submission 
will he immortalized in print, and we will mail you a cool 
Symantec T-shirt. 

special thanks to: Glenn Austin, Mark Baldwin, Levi 
Brown, Craig Conner, Andy McFarland, Christopher Prinos, and 
Kevin Quail. 


Q: Can 1 use STL with Symantec C++? 

A: Yes, Symantec C++ supports a modified version of STL. For 
best results, you need to use 8*0.3 of our Symantec C++ 
compiler. Patches are available via anonymous ftp at 

ftp://dGVtools.symantec.com/updaters/sym.qip-va-tdmpdate. 

Q: I’m using your new Pascal Universal Headers for THINK 
Pascal anti I get pages of link errors. Why is this? 


To receive information 
on any products 
advertised in this issue, 
send your request 
via Internet: 

productinfo@xplain.com 
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TCP/IP Scripting Addition The Internet Scripting Solution 


The TCP/IP Scripting Addition allows you to quickly 
develop Internet client/server applications using 
AppleScript®. If you want to script with MacTCP™ and 
Open Transport™, here's your solution! 

♦ Supports Script Editor, FaceSpan and HyperCard™ 
4 Build net-wise WebSTAR™ CGI scripts 
and NetScape™ CCI scripts 
4 Sample scripts include FTP, Gopher, 

Telnet, Post Office, E-Mail and more 
4 Featured on the Apple® Internet Server 

Order now through the MacTech Mail Order Store at 
805-494-9797 or other mail order stores 




Mango Tree Software, Inc. 

Box 1057 * Brookline, Massachusetts 02146 
617 527-8663 

1 1 L Lp ;//w w w, man got ree. com/bi zj rna ngo 


All trademark* dr t? prapertwts of iheir respective bolder*. 

Contact Mango Tree Software for site licensing and redistribution in formal inn. 
Copyright © 1996 Mango Tree Software, Inc. 



FTP Parameters 


Set these par art 
(sending) files i 


FTP Host 
Directory 


Telnet Ubr* 


User ID 
Passvord 


Type of file trai 

O MacBinary File 


^ Description: 


Telnet Library vl .0 

Copyright © 1995 Mango Tree 
All Rights Reserved 




1=L 


Record Stop 


m 

Run 


set my_telnet_3tream to tel nr 
tell my_telnet_stream 

try 

ConneeU your_host) 
read u nti 1 —text ("1 oc 


ACME TECHNOLOGIES Introduces ... 



Internet Daemon for Macintosh 


FingerToys is fully customizable! Run it as a Finger daemon 
out of the box, or write your own backend in AppleScript. 
Frontier, or C/C++/Pascal to support other protocols. 


Acme Technologies ■ 54 Fairfield Avenue • Norwalk. CT 06654 
(203) 857-0631 


• Power PC Native 

• Threaded 

* Scriptable 

■ Real-time status display or 
background-only daemon 

* Use as WWW->Fingcr CGI 
gateway lor WebSTAR 

Only US $79 

Demos and information 
available from 

http://www.acmetech.com/ 

Sales@acmetech.com 
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JAVATECH™ 


By Hiltel N. Cooperman and Aparajita Fishman, Cambridge, MA 



Java Rules 


A Java FAQ 


This is the first in what will he several 
articles on Java and the Macintosh 
implementations. Watch this column in 
the future for a beginner lesson on Jam 
programming and reviews of offerings 
from Natural Intelligence, Borland, Sun, 
and others for Macintosh programmers. 
- Contrih Ed, jaw 

Considering the amount of hype 
surrounding Java, it is nearly impossible, 
without a lengthy and thorough 
Investigation, to really understand what 
Java is all about, and to know what it 
can and cannot do for you. As an 
antidote lo all the hype, we are going to 
try to give some honest answers about 
Java in this article. We hope it will he 
helpful as you decide about how to 
pursue this new technology. 

According to Sun's “The Java 
Language - A White Paper", Java is a 
“portable, interpreted, high-performance, 
simple, object-oriented 11 programming 
language. Buzzword-shy it is not. In the 
questions lie low we will look at Sun's 
claims and explain what they mean. 


1- What is Java? 

Java Ls a programming language. It is really that simple. Much of 
the confusion on tills topic is from people mixing up what Java 
will enable with what Java actually is. However, for the purposes 
of this article, Java’s importance is based on what it is currently 
capable of doing. That's what well focus on. 

First a little bit of history. In April of 1991 the Java 
development team (or “Green” team, as they then called 
themselves) started work in a building located off of the Sun 
campus. Java was originally conceived as a programming 
language and operating system for consumer electronics devices 
(ix. set-top boxes). The team envisioned the technology being 
licensed in the same way that Dolby Systems licenses its noise 
reduction technology. While market forces shifted so that the 
set-lop box market slipped away as a potential home for the 
Java technology, the Web appeared on the horizon as a likely 
candidate for Java-based interactivity. With this goal in mind, 
Sun introduced Java in May of 1995. Sun’s current marketing 
reflects the idea that java is the “Internet application language." 
We will try to delve a little deeper. 

Yes, Java is a language but it is also a concept and an 
approach to deploying applications. 

2. What Is a Java Applet? 

As we said before, many people confuse Java’s capabilities with 
what Java actually is. The primary task with which people 
associate Java Ls creating interactive content for the Web. By this 
we mean a level of interactivity beyond the basic forms and 
buttons provided by a combination of standard HTML and CGI 
programming. An applet is a program that is called in the process 
of displaying 1ITML Calling an applet from HTML looks like this; 
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<KTKL> 

(KEAD> 

(TITLE)Applet Pa&e</TITU> 

</HEAD> 

<HOl)Y> 

(HA)Tbifl is an flKAorple of a Java applet:</H4> 
OIK) 

(APPLET CGDie-rayApplin .clsflft width=l00 height-*)!}) 
(/APPLET) 

<HR> 

(/BODY) 

(/HTML) 


Simple HTML 


. . . Sample Applet 

import browner <applet; 

Import awt.graphics; 

class nyapplet eicteiids Applet I 

public void paint(Graphics g) I 

g.drawstring!"Hello world.*, 25. 25); 

I 

I 


4, How Easy Is It To Go From C/C++ To Java? 

It is very easy. 

One of the Java team’s staled objectives was to keep the 
language familiar to the majority of programmers, Java's 
expression syntax is the same as Cs and it inoorponitcs the key 
object-oriented features of C++. This was done to give 
programmers a common reference* point when porting their skills 
to Java- Anti, from our fXTSpectlve, Java provides most of the 
power of C++ with none of the pain. This was achieved by 
avoiding those "features'* of C++ which, while providing 
tremendous power for those in the know,” are a source of 
tremendous complexity and IxTuddlement tor most programmers. 
In particular there are two potential pitfalls in C++ that Java 
avoids; raw pointers and multiple inheritance. In place of 
pointers, Java provides true type-safe arrays and strings, as well as 
runtime type-cheeked dynamic casting 


When a Java-enabled web browser (such as Hotjava or 
Netscape) encounters the APPLET tag, it loads the Java class 
(applet) referenced in the quotation marks. Once loaded* the 
browser runs the code contained in the applet and performs 
whatever function is specified by the code. 

Having applets run in your web browser wouldn't be such 
a greal feat t! they weren't small enough to be loadable in a 
relatively short jxtuxI of time; interactivity on the web is not 
very interactive if it takes an hour to load an applet Just as 
Macintosh applications are built upon the Macintosh Toolbox, 
which provides a significant foundation of core functionality; 
Java applets are built upon Sun s AWT (Abstract Window 
Ttxjlkin, a class library- which provides applets with their core 
functionality. Anti just as the Macintosh Toolbox resides on 
each user's machine, so too is AWT a part of each user's 
browser* obviating the need to load AWT over the net. The 
end result is that Java applets Lend to Ik* very compact* which 
translates into faster load times. 

J* Is Java Only Good For Creating Applets? 

Currently there are two options when using Jav a. The fiisl is to 
create AWT-based applets which can only run within a Java- 
enabled browser or application. The second is any programs 
which use only console input and output. Although used 
mainly for applets now, Java is a robust, general purpose 
language with many possible applications. 


5. Art Java Applets Gross-Platform? 

The Java specification actually consists of two parts* the 
language specification and the lava runtime environment. The 
language specification, like any oilier programming language, is 
independent of the platform on which it is deployed. Java's 
runtime environment is a byte axle virtual machine (VM) 
interpreter that allows an applet u> run on any given platform 
Think of it as a simulated CPU with a platform neutral machine 
language. 

The Java compiler compiles Java source code into Java 
byte code* and this byte code is executed by the virtual 
machine. Because the Java environment and virtual machine ate 
platform-independent specifications and have been ported to 
multiple platforms, compiled Java applets are themselves 
pJatft urn-independent. 

There arc* two browsers that are currently available (or are 
alxRJt to lx* available) that run Java applets. HotJava is Suns 
Java-capable browser (written in Java) that runs on Solaris and 
Windows NT. As of this writing, beta versions of a Java 
capable Netscape browser arc available on Solaris. Windows 
NT* Windows 95* and of course Macintosh 

6. Will Java A now Viruses and Desthi rnvK Programs 
to he Transmitted Via the Net? 

As we mentioned before, Java applets are built on iWT. AWT 
provides two levels of security. On the fir^t level. AWT 



FOR WE6 DATABASES 

http://www.everyware.cDm/adl/ 













. ..., .yiiL ., r i, *, uk. ...':;, I .yi ... 

Special Internet Section 

Sponsored by WebEdge 


prevent* applets from having free access to your computer s file 
system. So, for example, it would lx* extremely difficult for 
someone to write a Java applet which did any damage to your 
computer’s files. The second level of security involves a byte 
code verifier in the Java virtual machine, Thu verifier checks to 
see if any of AWT's security classes have been overridden or if 
anything in the applet will make the browser crash. If lx)ih 
conditions are met, it allows the non-offending applets to run 
in your browser. Otherwise, it rejects them. While a good 
concept, the verifier can lx- fooled; lx careful. 

7. How Fast is Java? 

The real question is, “How fast is Java in relation to other 
programming languages?" The answer is, Java falls somewhere 
tn between the speed of static languages such as C/C++ and 
dynamic languages such as SmallTalk. Preliminary benchmarks 
show that Java byte axles typically execute at about 50% of the 
speed of well written C code for processor intensive tasks. The 
bottom line is that Java is significantly faster than dynamic 
languages such as SmallTalk and interpreted languages such as 
Visual basic. The secret to Java's speed is the design of the 
virtual machine Instruction set. The instruction set is dose 
enough to must native CPU instruction sets that there is very 
little overhead in translating from Java byte codes to native 
instructions. Future versions of the Java byte code interpreter 
will be able to translate from java byte axle's to native machine 
code on tlte fly (also known as ^just-in-time compilation*), 
which will result in even greater execution speed. 

8. Why Does Java Have ^Automatic Garbage Collection” 
AND “MUL11*ThREADIN<i M ? 

OK, so rhafs really two questions. One of the priorities in 
creating the Java language was to keep die language simple. 
Or more specifically, the goal was to avoid a lot of the 
complexities of C++, One of the common complaints about 
coding is the work you must do to manage your memory, not 
to mention the consequences if you don't do it properly. 
Studies have shown that up to 50% of a programmer's time, 
when using non garbage-collected languages such as C and 
C++, goes into managing memory storage And, a significant 
amount of debugging time goes toward tracking down 
memory-related bugs. 


The beauty of the Java Virtual Machine is that it takes care 
of memory management for you. This process is called 
“automatic garbage col ten son. 71 A low-priority thread 
periodically scans your applets memory for unused objects and 
recycles die memory they were using. It does this by keeping 
track of what parts of your program are using memory, and 
determining when those chunks of memory are no longer 
needed. Many programmers mistakenly think that garbage 
collection is Inherently slower than manual memory 
management. This impression stems from die fact that up until 
now, most mainstream languages that used garbage collection 
were interpreted and thus inherently slow themselves, in fact, 
a well implemented garbage collector is on average as fast if 
not faster than the best implementation of manual memory 
management. A well-implemented garbage collector can be 
faster than manual memory management because it can reclaim 
unused memory in one fell swoop instead of in hundreds of 
small increments 

As for multi-threading, we just saw one very gixxl use of 
multiple threads. Aside From garbage collection, today's fast 
microprocessors can easily support multiple threads of 
execution, allowing more flexible and robust solutions to many 
classical programming problems. For example, any 
asynchronous task, which requires polling of a state flag, can 
be spun off into a separate thread allowing the main thread of 
execution to continue unabated without worrying about die 
result of the task. 

9. WiLVi is tin: Future for Java on the Macintosh? 

As we mentioned above. Netscape is planning to release a 
Macintosh version of its browser that is Java-capable 
Programming in Java on die Macintosh is a different story 
altogether. There are currently two options. As of this writing, 
Sun is planning on releasing a Macintosh version of their Java 
Development Kit in early 1996. By the time you read this 
article. Developer Release 1 of Roaster™, the other option on 
the Macintosh, will lx* shipping. No discussion of Java in a 
Macintosh programming magazine would lx* complete without 
mention of Roaster, However, Roaster is a product from our 
company. Natural Intelligence, so Ml keep the marketing to a 
minimum and give you the basics. 

Roaster is an integrated development environment for 
writing java applets. Roaster consists of several components: 
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Project Window 


Source Code Editor 


Runtime Engine 


Compiler 


Tit is is used for the organization of 
your source code and compiled byte 
codes in a Finder-like view. 

The editor includes a toolbar with a full 
suite of code-editing functions, context- 
sensitive color and style syntax 
formatting, and drag and drop support 
This allows you to put up a native 
window in which you can test your 
applets. 

The compiler generates Java byte codes. 


We're including this description in ihe article to give you 
an idea of what will be in Natural Intelligence’s Macintosh 
applet development environment for Java. But hopefully. Sun's 
environment will be out s<x>n, so that you will have more than 
one option for developing in Java on the Macintosh. 
[Metrowerks has announced support for Java development as 
well. See Newsbits. - Ed. Asst, jtkj 

10. Whfrf. Can I Get More Information? 

1 always balk at pin ting references to the net in articles that 
won't be published until weeks after they Ye written. The net is 
so dynamic that they may end up Ixing out of date. So cross 
your fingers and check out these resources. Most should still be 
relevant by the time you read this, though I’m sure that rhere 
will lx? many more by the time this is published. 

Java Home Page http://fava.sun.com/ 

John December presents Java 

Imp; //www, tpi.edu/-dece mj/works/java, html/ 


Java Jive 

Natural Intelligence, Inc. 
Gamelun Java Resource Registry 
Java Usenet Newsgroup 
Java-Mae mailing list 


http://cata log. com/ddd u/java jive, him 1/ 

hupJ/www, natu ra I .com / 

http://www. g amel anxom/ 

iews:comp.lang.java 

send “sdbstTlbe java-mar* to 

majordomo^naturaLcom 


These are just a few of the resources out there. Keep your 
eyes peeled for the inevitable avalanche of books and 
magazine articles on the subject 


Summary 

In closing, despite your natural reaction (as a marketing saw 
programmer) to dismiss the hype surrounding Java, there really 
is something to get excited about. While Java has its 
limitations, it is a definite leap ahead of today's industry 
standard programming languages and approaches. With your 
support of the language, there is no doubt that Java will 
continue to thrive in the future. 


Did tfou /Cnow? 

tfoa. can hare fadcode distinf 
werg month with a d/si subscription. 

See the Staid Order Store section 
fa rates. 

CaH, fa, or write to order for 

disi subscription. 

See How to Communicate withXpdain 
Corporation on pope 2 fa contacting. 
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By Dare Mark 




Java Talk 


You, the MacTecb readership, have been 
long asking far a Metnmwks presence in 
the magazine 'Jhis is the first in a brand 
nett series of articles by longtime 
Mac Tech columnist Dave Mark Dave 
recently joined forces with Metrowerks to 
produce a series of CD-ROM based 
prog ram min# products. This monlb, 
Dane interviews Greg Galanas , president 
and CEO of Metrowerks. about 
Metrowerks recent announcement on 
their new jam development eminmment. 

Daw: Metrowerks Just announced the 
first Mac-based Java development 
environment. What can you tell ine 
about it? 


bring them to our user base as a first developer release in May. 
Tills means well support source level debugging, browsing and 
compiling as if you were working with C/C++ or Object Pascal 
within the IDE. 

Dave: If you want to jHoducc Java applets, you’ll have Lo learn 
the Java programming language, something akin to learning 
C++ Do you think Metrowerks will ever offer a way for non- 
prt Jgraiumers to produce Java applets? 

Greg: Allii t the holy grail.... Metrowerks is committed to 
building better, easier lo use tools. I suppose the cryptic 
response would Ik* to say that we will support Java in much the 
same way that Borland wall support Java..,* The answer here is 
that we will strive to do so bin it's nor a short-term proposition. 
This will take time, but yes, we are moving quickly towards that 
goal and will be taking Constructor down that road. 


Greg; We've been tracking Java for over 
a year now, noting the developments in 
the field and the positioning of the 
language with respect to hue met 
development, A little over four months 
ago we initiated contact with Sun and 
developed a complementary position in 
order ro properly support Java 
programming and Internet development 
within CodeWanor. 

The Sun deal was signed a couple 
of days before Comdex. It is both a 
licensing and a development deal where 
Metrowerks will license compiler 
technology, runtime interpreters, Java 
classes that support cross platform 
development, as well as the Hotjava 
browser. These technologies will be 
.seamlessly merged with the GxlcWarrior 
Development Environment in order to 


Dave: What is Sun's role in all this? 

Greg: Sun has been working on different manifestations of Java 
lor about 5 years. It came out of some pretty serious K&D 
efforts into embedded appliance systems. It was found at that 
time that C++ was not ideal for embedded, secure development 
tjccausc of what Sun calls unsafe language features: pointers, 
operator overloading, multiple inheritance and the absence of 
garbage collection, (Note: multiple inheritance is available in 
the Java interface, but not in the classes themselves). Java is a 
language that Is very close to C++ without die features Unit are 
considered insecure or dangerous, especially for a Sanguge 
designed for building programs that are downloaded to your 
desktop machine and which will then run there. 

Sun is doing some very interesting things in order to 
nurture Java and cross-platform Java implementation, for 
instance, they arc licensing their technology and working with 
strategically chosen desktop partners in tools (Metrowerks, 
Borland), communications (Netscape, Spyglass), content 
development (Macromedia, others). But they are also 
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The professional web page development tool 

• Tables 

• Forms 

• Page Colors 


f Add your own tags r / 
And much much more! 



For Si fatty functioning demo, point your web 
browser to http://www.northneLoig/besl/ 

Best Enterprises (315) 265-0930 


controlling the iixhnology and the language standard until the 
language is embedded* so to speak, in Interne! development in 
order to stave oil the fea twins that comes from standards 
committees (I point to C++ as a specific example of this). This 
is a good thing — actually the reverse of what usually happens 
with a new language. 

Finally, Sun is controlling and furthering the security 
technology that will guarantee lliat a Java applet is, in effect, 
secure Part of the technology licensed from Sun addresses the 
areas of security anti validation, what is applied to the Java byte 
code stream once n passes the threshhold of your particular 
desktop machine. 

Metrowerks and Sun have teamed up to ensure that 
Macintosh plays ait important role in Java development This 
relationship is Ixith one of making the tools available to our 
customers in a timely manner (WWDO and also working wiili 
Sun on market-creaturn strategies. MW lias licensed all the Sun 
technology and will be rolling new technology into its Java 
products as time progresses, Of course. Metrowerks will also be 
developing new technology for Java, optimization techniques 
for runtime improvements, AWT (abstract windowing toolkit) 
support, interlace building tools, etc. This is a long term play 
for us and we intent! to support our customers in their quest to 
program the net and increase their own revenues. 


Dave: Will developers have to pay any royalties on applets 
they build using JavaWerks? Are there any licensing issues 
developers need to lx* aware olV 

Greg: Wow, ’JavaWerks'! Quick, let's gel a trademark! Seriously 
though, applet developers shouldn't have to worry too much 
about licensing issues unless they are also shipping the byte 
code interpreters. Sun is si riving lo make this technology an 
open platform: therefore there axe no direct royalties or other 
costs associated with developing and shipping applets. Java 
implementers such as Metrowerks and the other Java official 
licensees bear the burden of the royalties in a distributed 
manner, so it makes a lot of sense from a developer's 
standpoint. The Implementers are held to a very high standard 
and must pass all sorts of validation suites IxTore shipping their 
Umlsuite. Tills is because Sun absolutely wants Java to lx cross- 
platform, and for this to be achieved much more validation 
must be applied to the tools to ensure that the compilers 
generate the proper byte code for any particular release. 

Dave: What impact do you think Java applets will have on 
more mainstream application development? Fur example, do 
you think well ever see a Java word processor or spreadsheet 
applet? If so, how will folks pay lor It? 

Greg; 1 think there arc really two markers here. The first is the 
development of applets or small applications that live on a Web 
server and execute a specialized function that an end-user 
wants to acquire. Til take the easy example: Imagine a 
specialized applet that implements peer-to-peer communication 
with a stock quote server (local Java applet talks to remote Java 
applet 1 and warns you when you should buy or sell. An end 
user is likely to see value in this applet and be prepared to pay 
a price of Clefs say) $9,95 a month lor this service. Result: 
applet developer sells to end-user without traditional 
distribution channel There are many, many examples of this 
from gardening, to cooking, to special travel deals, that a 
consumer will l jo interested iu procuring in the home directly 
from the service provider 

The second market is for todays applications vendors tour 
customers) 10 hoi wire their application to the Internet either by 
implementing applets in their application suite that can lx stmt 
off across the net to “do something" or by emlxdding applet 
technology in their application to host applets that are 
downloaded from the net. This could lx as simple as running 
the applet in a web browser, or as complicated as allowing the 
applet to actually "plug in to the application itself, Again, the 
consumer could then choose from any specialized applet that is 
destined to work vvith Claris Works nr KreeHand or Illustrator, to 
give a few examples. lxx»k at tlie Java runtime mode 1 ! as a very 
lightweight, multithreaded container architecture without SOM 
and the fragile base class problem that happens to be the 
Achilles' heel of C++. This is a powerful concept. 
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Hang Ten with Mach 1 


Make Your Macintosh An Internet Server 

Mach” Rives every Macintosh from Classic to PowerMac & PowerBooks: 

1. Unlimited Web 'Home’ Pages 

2. Unlimited TCP Connections 
3- Unlimited Mail Accounts 

4. Unlimited Internet Addresses 

5. Unlimited Domain Names 

6. Domain Name Service (DNS) 

7. POP Mail Service 

8. Mac/UNIX Pile Sharing 
9* Mac/UNIX Printer Sharing 

10 . Unlimited Possibilities 



MacUS mid UNIX on a single 
machine the best of both worlds. 


Macfi is a compact I NIX operating system that runs seamlessly with 
the Macintosh operating system to let your Mac reach tis full potential. 


for more information, or to ordur call 

I 1 - 800 - 6 -MACH- 10 

internet: info@tenon.com http://www.tenon.com 
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Dave: Java is normally compiled into byte-code. Then 
interpreted. Will there ever lx* a fully compiled Java with no 
interpreter in the loop? 

Greg: Essentially, the byte rode runs on the Java virtual 
machine (the interpreter) which translates the byte-axle into 
native instructions. I think you'll see both just-in-time compilers 
and hybrid dynamic/jntepreted compilers that will lx* necessary 
to speed up local execution. So the answer is Yes. The real 
question Ls: “When?" 

Dave: Where on people go to gel more information? 

Greg: Well, the fastest way to get to all the hot Java sires Is to 
go to http ;/iwww. menowerks.com. We have a full hookup to 
licenses sites, user sites, Sun's numerous sites. The other place 
you can go is to http://java.sun.com (but we point there tool). 
There’s also the newly created newsgroup news:compjang.iava 
which has nearly as much traffic as 
comp,sys,mac.pTogrammer.codewarriot. The java newsgroup is nearly 
absent of Mac programmers, who have noi had the tools to 
date. We definitely are going to change this. You can also send 
email to java@meltowerks.com to receive info on beta testing. 


Dave: Who the heck is Duke, and why is he stealing Ahnold's 
limelight? 

Greg: Hey, Duke's cool. He's the Java mascot, a molar-shaped 
imp with a red nose carrying a surfboard I can just see Arnold 
surfing the web jolted out of his brain on this Java stuff. 
Arnold and Duke are buddies. Arnold is Duke's protector. Like 
Terminator II, yeah. 



January 1996 * MAdTECiiMAGAZiNii 


Java Tai.k 


57 


























' 

S»wf| 


Special Internet Section 

Sponsored by Web Edge 




By Brad Scbrick and Eric Bickford 



Becoming a Macintosh Service Provider 


Tales from the field 


For several months MacTecb has 
published articles explaining how to 
configure and program Internet WWW 
servers Of course, Macintosh Web 
development isn't just programming: 
there’s money to be made! Eric 
Bickford and Brad Schrick, two 
professional Macintosh WWW 
developers, report on market conditions. 
The forecast is sunny. 

Eric Bickford 

It began innocently enough. Put up a 
few web pages and see what happens. 
Seven months later the Mac Web Con¬ 
sultants Directory http;//www.macwebxom/ 
had received listings from 440 
consultants in 20 countries throughout 
the world (80% of those in the USA). 

The Mac Web Consultants Directory 
was launched in April 1995 at 
WebEdge I, the Macintosh WWW 
Developers Conference. The idea 
behind the Directory was simple: 
Provide a searchable database of 
consultants who are experts in 
electronic publishing on the World Wide 
Web using Apple Macintosh and 
com pat ibtc computers. 


listing 

To register, a consultant need only complete a free online 
application form. The application form asks for contact 
information and a short description of the services the 
consultant offers. This description becomes the consultant's 
primary vehicle for attracting clients who search the Directory. 

The application form also lias a skills matrix for Services, 
Scripting Languages. Database Programs, and Web Took Any 
individual consultant might be skilled in CGI programming 
using AppleScript, C++, or Frontier They might be .skilled with 
a Macintosh database like 4th Dimension, Butler, or FileMaker 
Pro. Or, they are skilled in a specific web-related tool like 
AppJeSeardi or NetCloak. 

Once a consultant creates a profile, they have the capability 
to update their profile at any time. Should a consultant be 
unavailable, for example, they're encouraged to update their 
availability status to “Booked SulkT. 

Searching 

The Directory’s web based search screen is very simple: 
Select the field you wish to search, such as “City", and enter a 
search term Results of a search are rerurned as a liitlist ol 
records with consultant contact and profile information. Small 
icons on each consultant profile give an indication of the 
special skills that a consultant might offer. 

The individual consultant must sell himself. Each listing in 
the Directory should have a URL pointing to the consultant's 
home page The quality of a consultant's home page Ls often die 
primary selling point for acquiring new projects. 

It Actually Works 

large and small companies and organizations use the Directory 
to find experts to help them build mission-critical, industrial-strength 


Brad Scbrick and trie Bickford - Brad Schrick is a consultant in Palo Alto, CA. Eric Bickford is the author of Web FM and 
a product development engineer for the Web Broadcasting Co. in Palo Alio, CA, 



Becoming a Macintosh j Sfkvkjh Provider 


MAcfTi-o (Magazine • January 1996 
















Special Internet Section 

Sponsored by WebEdge 


The #1 debugging and development environment for AppleScript ! 



Real step-by-step debugging 

Variable watcher & 
expression evaluator: set 
variables, in context, during 
debugging! 

Enhanced trace log 
FaceSpan™ link 


• Vocabulary access in a 

mouseclick 

• Power-assisted statement 
construction 

• Multifunction find & replace 

• Automatic navigation to 
subroutines 

• Background processing 
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[ you're an AppleScript novice, Scripicr will take you by the 
hand and show you the correct syntax for ynur statements 
If you know what you're doing, Scripter will help you do it 
faster than any other editor. Scripter lets you debug properly: 
truly line-by-line, so you catch the offending code in the act. 
And only in Scripter can you then fix the problem, and 
continue debugging right from where you left off. In fad, 
Scripter has so many exclusive features, we can't list them all 
here So get a copy today and start scripting with power! 

"Overall value ♦ 

Scripter 10 is top AppleScript editor and debugger.,. 
If you expect to do anything more than idle fiddling 
with AppleScript you need Scripter.'* -MscWeeK 6/12/95 


+1 202 298 9595 maineuent@his.com AppleLink: main.event 


solutions on the WWW* Its rewarding when you plan and build 
something like this Directory and it actually works. Again and again 
t find tm talking to or reading email from someone in the directory 
who mentions gelling a project or referral f rom if. 

The Directory, however, isn't without some problems. Because 
listing as a consultant is Free* some people have listed themselves 
who arguably si a hi Id ntM lx i in the Directory. For example, a <[uick 
search of the Directory finds tlut not all consultants liave a home 
page URL Likewise, an even 10% of all consultants listed liave an 
email address with an .edu university top-level domain. 

Brad Soirioc 

In mid-1993 Chuck Shotton wrote 4 MncHTIT, and showed that a 
Macintosh could lx: a competent server tin the Wc >Hd Wide Web. 
By late 199a there was a lively group of commercial educational, 
and personal Mac OS WWW servers using MacHITP on the VJfeb. 

Show me 

However, despite these many examples and an active 
discussion list, even Macintosh advocates often believed that 
UNIX was required to serve pages on the WWW. Instead of 
arguing endlessly, Brad Sehrick, a Mad DTP advocate and 


customer, decided to try to list the servers that use Mac OS to 
deliver World Wide Web services. 

The list debuted in October 199-1 

The lirsi listings were easy to choose, starling with Chuck s 
site on his I Icl at the Unive rsity of Houston ( now 
www.biap.com), Apple's front door, tended by Dale Mead at 
www.apple.com on a Mac: ITfx, Stephen Collins’s Web66 ‘WWW 
cookbook' at web66,coled,umn.edu (with several other Mac 
WWW sites}, Jon Wiederspanks CGI tutorial (http:// 
www.uwtc,washington.edu/computing/www/Iessons/) ar the 
University of Washington, and alxiuL SO others. 

Over the past year, the lists were automated to allow Mac 
webmasters to enter and change their own listings, and the lists 
were grouped by new listings, geography, equipment, and 
software in a continuing process to help Mac webmasters 
evaluate techniques and markets for their work* 

The Mac WWW Server lists ai http://brad.net/macwww/ 
currently hold about 1100 listings for about 900 to 1000 distinct 
Mac .servers from around the world, and are growing at a pace 

Continued on pagp 94 
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By Alan B. Oppenbeimer 


Inside HomeDoor 


Make one web server act 
like a net work of servers 


TV HomeDoor™ Default Home Page 
Server is a ncwly-an non need product 
from Open l)<x>r Networks* HomeDoof 
enables a single Macintosh Web server 
In serve default home pages for multiple 
domains. This article describes the 
inner workings of HomeDoor* 

Pioduct Summary 

HomeDoof is a Macintosh extension and 
associated Admin application which 
enables an Ethernet-based Macintosh to 
redirect requests for particular default 
home pages to particular suIkII rectories 
on any Web server. For example* 
HomeDoor can redirect URLs of the 
form http://www 1 companyX,com/ to the form 
hrtp://www.yourwebserver,com/companyX/ 
HomeDoor supports up lo 256 such 
redirections, allowing you to set up a 
large mimlxrr of default home pages on 
a single MaeOS-basetf Web server. 
HomeDoor also supports the creation of 
complete “virtual* domains associated 
with each of these home pages. 

The Web server (or servers) to which 


HomeDoor redirects requests do not necessarily have to lx* in the 
same machine, or even on the same network, as I lomeDoor. You 
configure HomeDoor with a unique IF address for each default 
home page it is going to serve. You will also generally want to 
assign a domain tunic, such as wvvwxonipanyX.com, to each of 
these addresses. For each address, you then configure HomeDoor 
with the I KL lo redirect that address to. Wlien HomeDoor gets 
an HTTP request lo one of tlie addresses it's managing* it redirects 
dial request to the configured URL 1kimeDoor can be* used to 
serve default home pages in this manner and also to serve full 
“virtual* domains* redirecting not only URLs of the form 
http://www.compafiyX.com/* but also URLs of the form 
hUp://www.companyXxoin/fi!e’Or-direaofy. When redirecting such 
URLs. HomeDoor preserves the “file-or-di rectory" part, thus 
supporting the creation of complete v inual domains. 

MlJLllliOMlNO -Till: KliY TO HOMEDOOR 

The key architectural comfxmeni of HoineDcxir is muhthoming 
Multihoming is the ability of a single physical node on a 
network to have more than one address (or home") on that 
network. Neither MacTCP nor the TCP IP implementation in 
Ojxti Tninsjxjit provides multihoming* although Apple intends 
mullihoming to lx* a feature ol Open Transport 2.0. HomeDoor 
thus had to implement a simple form of inultihoniing itself, 
HomeDoors mullihoming & limited to those Internet proux'oLs 
required for HTTP (specifically ARP, IP and TCP), plus a small 
subset of ICMP so that HomeDoor can respond to pings for its 
addresses. HomeDoor docs not provide a general-purpose 
implementation of multihoining 

HomeDoor's mufti homing is implemented directly on top 
of the Macintosh Ethernet driver* below the TCP/IP stack. 


Alan II uppenheimer Alan B Oppcfihrimer was pan of the original team dial created the AppleTalk network system 
Alan was responsive for the design of many of AppleTalk's lower layer protocols and led the team at Apple responsiNe for 
the Apple Internet Router and Apple Remote Access Alan left Apple to found Open Door Networks, Inc. in January of 1995 
Alan's email address is alan@opendoor.com. 
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HomeDoor tells the Ethernet driver Ui pass ii nil packcLs of 
Fihemet type ARP* or “IP/ Because of the way the IP protocol 
suite works, the packets Home Door needs to receive are either 
broadcast (ARP packets), or sent directly to the Macintosh's 
Ethernet address UP packets). This fuel is important, because it 
prevents HomeDoor from needing to have the Krliemet driver 
listen to every packet sent on the network, which would 
adversely affect performance. 

After Ixing passed an ARP or IP packet from the Ethernet 
driver, HomeDoor determines if the packet is intended for an 
address in its address range. If the packet is in range, 
HomeDoor processes the packet as appropriate, implementing 
the required parts of ARP. IP. TCP or ICMP If the packet is not 
in HomeDoor's address range, and MucTCP is running, 
Home Door passes the packet to MacTCP. Otherwise 
HomeDoor discards the packet, Hy passing packets ro MacTCP, 
HomeDoor can run on the same Macintosh as any MucTCP 
diem or server, anti specif jolly in the same Macintosh as a Web 
server lor which it is serving default home pages, HomeDoor 
does not, however, require MacTCP to run. HomeDtxir also will 
not currently nin at all on a MacinUish which is running OfX-n 
Transport, due to OTs radically different driver architecture 

Redirection 

As shown Inflow in figure I, HomeDoor takes advantage 
of a feature in HTTP known as reriiasiion. A browser wishing 
to look at a Web page issues an HTTP GET command to the 
address indicated by the first part of tile I. HI, after obtaining 
dial address from a domain name server (DNS), It the address 
is being managed by HomeDoor. HomeDoor receives the 
request and returns an HTTP REDIRECT in response. The 
REDIRECT contains the actual I'KL of the associated default 
home page. The browser receives the REDIRECT and then 
requests that page directly from the actual server, using the new 
URL From then on. the browser talks directly to the Web 
server if other (relative) links on that server are accessed 
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The Macintosh WWW 
Developers Conference 


WebEdge at Macworld 

Featuring cutting edge advice 
from leading Web experts 
and developers 

Mow to Build Youi Own WWW Smet 
Without Really Trying ♦ Commercial CGIs 
Connecting Your WWW Server to Back-End 
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V irtual domains 

To lx.* precise, HomeDoor actually does more liian simply 
returning, in the- REDIRECT, the URL that has been configured 
for tlie address requested. Technically speaking, HomeDoor 
actually replaces the part of the t KL which specifies the Well 
server itself with the I RL to be relumed. So a URL of the form 
http://wwwxamponyX,com/ is returned as 
http://www,youivvebservef,com/companyX/, but a URL of the form 
http://www.companyX.com/file-Qr-cfirectory becomes 

http://www.yourwebservercom/companyX/file'Or-directory. Since the 
"filcor-directory* pan can in fact be arbitrarily long, a full 
"virtual* domain can be served by HomeDoot: 

Completing the illusion 

Home Door effectively allows a single Macintosh Web 
server to serve default home pages, and in fact full virtual 
domains, for up to 2% different domain names. HomeDoor 
does so in a manner that is almost totally transparent to Web 
browsers. The only significant exception Ls that most browsers 
display a page's actual URL in their ‘'location" I ield. Thus, for 
example a browser user would see the URL 
http://wwwyourwebservef.com/companyX/, even though they typed in 
or accessed the URL bttp://wvwv,companyX/. Even this minor side- 
effect, however, can ix # eliminated by using a DNS to set up an 
appropriate alias to the actual Web server, and using 
HomeDoor to redirect to that alias as opposed to to the Web 
server itself For instance, instead of redirecting 
http://wvmcompanyXxom to http://www.yourwebs&rvercom/companyX/, 
you could redirect it to http://www2xompanyX.com/companyX/. 
where www2xompanyX.com is an alias for www.youfweb 5 ervef.com. 
In tills way, not only wilt the Web browser user see the correct 
domain name in die "location" field, but it will appear to the 
user that the domain in question has not one hut two complete 
Web servers associated with it (www.companyX.com and 
www2. a 1 m p; 1 try X .com). 

Subtleties of HomeDoor 

the UomeDoor design contains a number of subtleties 
which might not be Immediately apparent. These subtleties are 
based on the fact that HomeDoor allows you to enter a full 
URL for each address it is managing. This flexibility allows, for 
instance, a single HomeDoor server to serve home pages and 
virtual domains for more than one Web server. And, although 
HomeDtxir runs on a Macintosh, there is no reason that the 
Web saws themselves need to lie Macintoshes. HomeDoor 
can serve default home pages lor any type of Web server 
whatsoever. HomeDoor can also redirect URL's to other 
network services, allowing, lor instance, an Hi TP URL to in* 
redirected to an FTP server Finally, with some small 
modifications, the HomeDoor architecture can be enhanced to 
provide many additional services One area for immediate 
investigation involves having HomeDoor redirect a particular 


URL to a URL chosen randomly or sequentially from a group of 
other URLs, enabling HomeDoor to serve as the front end to a 
Redundant Array of Inexpensive Computers {RAIO, 

How To Find Out Mori 

Open Door Networks maintains a complete set of home pages 
on the HomeDoor product. Not only do these pages include 
product details, example pages served by HomeDoor and a full 
copy of the HomePcxjr Users' Guide, but also a downloadable 
evaluation version of the current release of HomeDoor. The 
HomeDoor pages are at http://www,opendc>orxom/fiomedoor/. 
General information on Open Dtxir Networks, one of the first 
Macintosh-based Internet service providers, is available at 
http://www.opendoorxorn- Specific questions should l>e addressed 
to help®opendoor.com* 

(For those of you that would like to see a real life 
example of this technology, we use HomeDoor on one of our 
servers in the Xplain Corf?./MacTecb offices. In fact, the 
www. mac tech „ co m and www devcentraicom weh sites are 
redirected using HomeDoor 7 his allows us to ham an all 
Macintosh Internet site without having to resort to Unix, We re 
very pleased with this solution. 

There are some minor limitations to the way that 
HomeDoor works (although it does benefit from an all 
Macintosh user interface). If you want a different solution. 
Unix does offer the most complete "multi-homing” solution 
available. And, if you want to stay with the Macintosh (and 
why wouldn't you?), then MacbTmfrom Tenon is your answer 
- it's a kinder, gentler l 'nix. :) - Tub nstj 

* 
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CGI’s: AppleScript or Frontier? 


Comparing scripting 
environments for CGI 
development 


In a previous article, “Scripting the Wet) 
with Frontier 1 ’, 1 introduced you to writing 
CGI scripts using UserLand Frontier In 
that article, I argued that Frontier was an 
excellent alternative for webmasters who 
felt forced to choose between the poor 
performance of AppleScript and the steep 
learning curve of C because Frontier is 
easier to use than C yet generally performs 
faster than AppleScript, especially when 
used to create CGI applications. That 
argument became even more true when a 
PowerPC native Frontier was released for 
public Ix'ta-tcsLing in late October Like 
dropping a bigger engine into a hot rod. 
script execution instantly becomes much 
faster - in some cases up ro six time faster 
With this boost in speed on PowerPC 
machines, Frontier is closing the gap on C 
- offering U)ih easeohuse and excellent 
performance - while further increasing its 
lead on AppleScript, 

Despite the proven benefits of using 
Frontier to write CGI applicatioas, many 
webmasters still are developing their CGIs 
in AppleScript, This inspired me to look a 
hit more closely ai the differences 


between CGI applications written in Frontier and those in 
AppleScript, primarily focusing on performance issues. In this article I 
will share the results of some of my recreational performance tesLing, 
and explain some of the different situatioas that affect performance. 

Since I am the author of the Frontier CGi Framework, a set of 
scripts that enhance CGI development in Frontier, you could 
understandably question my objectivity in doing such a comparison. 
On the other hand, since I have done a great deal of CGI development 
in both environments, I am also one of the few people qualified to do 
such a comparison. In either case it is not my intent to discount 
AppleScript as a scripting environment I rhink it is a great product and 
an important technology. 1 just don't believe it is well-suited to the 
specific task of CGI development. 

Performance 

Performance is crucial to CGI applications running on busy servers. 
The more processing time a request takes, the more likely a user is 
to give up and move on to another site, 

fVe often been asked if Frontier is fasier than AppleScript. The 
truth is, when comparing built-in verbs in AppleScript and the non- 
nalivc version of Frontier, the performance is surprising similar. I 
ran a series of informal tests to compare the performance of 
AppleScript, non-native Frontier and native Frontier when running 
equivalent scripts. The scripts are based on the sample scripts from 
Frontier's object database. AH tcsis were run on a Power Macintosh 
7200/75 with 16 MB RAM, Execution time is measured in ticks 
(s i xt ieths of seconds), 

Tlie first test script performs simple integer arithmetic using 
built-in commands In both the AppleScript and IJserTaik versions. 
'Ihe actual scripts are functionally identical. 

Test t: Integer Arithmetic (AppleScript) 

set x to 0 

repeat with i from 1 to 1000 


Mason Hale - Mason Halt* is Director of Internet Services for VfersaCom, Inc - an Austin, Texas-based on lint? communications 
and Internet marketing Firm, He is the author of the Frontier CGI Framework and President of the Capitol Macintosh Users Group. 
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set It to i I (12 * M + $7 t 84) 
ond 


Tea l: Imqscr Arithmetic (UtcHUi} 

tor i ^ 1 to 1000 

x - x + (12 * W - 1/ / H) 

AppleScript took 111 ticks to complete the first test* while 
the non-niifive Frontier nxjk 103 ticks. The PowerPC-native 
frontier ran the same scri(H in just 17 ticks. This first test really 
shows how close the non-native frontier and AppleScript were 
- and the tremendous difference the native version makes. 

The second test demonstrates the repeated calling of a 
local subroutine. 


Test 2 Suhnnrtlflc ( jII <AppIcSt ripo 

set y to 10 
on noof (x) 
return fx * 2) 
end 

repvul with 1 from I to 11100 
set y to wiof (y) 
end 


l cm 1 NtilMiHJiuic Ull (lAcrlatk) 

y * HI 

Otl blMlf (*) 

toturn {* • 21 
for i * I to 1000 
y - moot ty) 


AppleScript blew the door* of the non-native Frontier in 
file second lest coming in at 8S ticks to frontiers 111 tkks. 
However* the PowerPC, native Frontier handily won with a time 
of >\1 ticks. 

'Hie thin! script compares the performance of commands 
from an external Scripting Addition to a built in Frontier vert). I 
compared the speed of Frontier's built-in dodenow verb to the 
equivalent current dale Scripting Addition. 

TrM l KmlHn verb vs Scripting Addition 

for i - 1 to 100 
y * clock*now 0 


Tot i: Jkiili m verb v> SitijHrng Addition (AppleScript) 

repent with l fron* 1 to I DO 
m y to current dale 
end repeat 

Ji tf x>k AppleSt ript 113 lit ks to ei h iiplcte lhis test, w hlie 
the non-native Frontier look 17 tick* and the native Frontier 
look 1 ticks* Tliis illustrates a crucial point in determining the 
speed of a script, built-in commands are faster than commands 
loaded from external code fragments Because AppleScript has 
few luull in verbs and relies heavily tin Scripting Additions to 
extend the language, the use of external commands like 
“current date" is quite common. 

In the fourth example llie script checks the existence of a 
file* Frontier uses a built-in verb “file,exists*. while AppleScript 
communicate* with the scriptable Finder via AppkEveniv 


Tot I HuilNrt verb vn Apple Even! (AppleScript! 

set * To II * 1 * 


CGFs; Ain't kSchipt < w Fkovttkr? 


tell Application *Find#r* 
repeat with i from 1 to 10 

If ox lets alias "Natintoali SD:SispleText* then 
aet x to x + I 
end it 
end repeat 
and tail 


Tot 4; tknll-in verb v* Apple Event <t\crTilk> 

Inral (x - 0) 
for 1 ♦ t to 10 

if file-ax laris ("Hnrintojih HDiSimpleText*) 
x++ 

Inter-apptication communication tan really slow things 
down. Each cross application Apple Event adds approximately 
h » second to the processing time of the script. Frontier suiters 
the same slowdowns when sending Apple Events to other 
applications, hut because more commands are available, 
external applications are relied on less often, 

The results of the fourth test hear this nui. While the native 
ami non-natjve Frontier applications finished in 3 ticks and 7 
ticks respectively, AppleScript took HO ticks to perform the 
same task using the scriptable Finder* 

My final test was “real world example* based on the 
“testegr script dial is distributed with Mucin tP. This script 
uses no scripting additions and doesn't perform any cross- 
application communication. So it is a pretty good example of a 
common CGL script using built-in vertis. 


Tcnj A Tcm CCil (AppleScript) 

property crlf i (ASCII character 13) 4 (ASCII character 10) 

thi* hnkh iNr mxmal MTTF header tor rquiUr 

property hUpUOJieodcr : -HTTP/t.O 200 OK" A crlf A - 
•Server: HacIITTF" A crlf h "fOUF VenOam 1.0" £ - 
crli £ “Content type: tvxt/hind" A ertf A crlf 

on cgiSeript (path^atfft, http*_Gt?firch_atg!i, jfrcrn.mvr * -* 
ptifluwr^d* from uiiflr, client address* servur^ttaiac* ■» 
newer port* script name* cotitent_type. referer. ** 
u*vt ,ugcMt, Oil ion* action path* post argE* method* ^ 
cliwnt_ip. fuil_requo«l) 

try wrap the wbuk xtif« in an i rmr handler 

return http_l0_header k “<title>Tesi C0K/titl«>" b ■* 
*<h2>Tefft CGK/h2><u>CGI argurxentfi acni :</u>* h “* 
"<br><h>pnth:</b> • & path_args k 
“Ct>r>(b>Bonrch:</ti> * h http search^args A “* 
"<br><b>pom_urftG :</b> H A post ergs A * 
“<br><b>BiMlhyd:</!j> p A im>i hod A -* 

,, <br><b>addreix:</b> ■ k i Hem_addresr* A 
"<br><b>userK/b> * h user name k “* 

- <br><b>pafixword:</b> " A password A ■* 

“<br><b>fro«:</b> " b fron_ueer 4 ^ 
•<br><b>server^n#«e:</b> " A server.name 4 
■<br><b>serv(?r_pof t :</b> " 4 server port 4 * 
*<brKb>8Cripi_naxt , :</b> " 4 script rale 4 "* 

*Cbr><b>reterer:</b> * k referrr 4 
*<br)(ti>u6tr ageot:</b> • 4 user_a^ci*i 4 "♦ 
•CbrKb>contem type:</b> " 4 ccmient^typc A rrtf 
on error nunber nua 

rciutn hitp_J0_hc.»der 4 "Error " A nun 4 ". " 4 msg 
end try 

end caller 

repeat with i from 1 to 10 

rRlSrrtpt (“aaa"* "bbb". "ccc"* "ddd“* "eeo*. ^ 

“fff, m lU m , m hbb m . "jjj"* -kkk". - 

■111*. "rno“* *aoo m * “ppp". ‘qqq*. w rrr") 

end repeal 
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Test 5c Test i'i'A (UsetTaft) 

on Script (ptthArgi, IttpStirdlArjii, uBernaac. \ 
password, lroaUser* c 1lentAddross, serverNji»p, \ 
serverPort, icriptNaac* contuatTyp*. r«ff*rt*r* \ 
userAftent, action, •ctirmPaTh* postAr^s* method, \ 

cliantlp, fid l Request ) 
try 

return tvtrUServer .httpUeader t) + \ 

<<tiLle>Tm CCK/titl«KM>T**t CGI</h2>* i \ 

*<u>CCI arguatntf aent:</u>" * \ 

*<brXb>path:</b> * > jirtthArgn f \ 

, <brXb>jifiarcti;</h> " * hn pSco i chArgs + V 
1, <br><b>pdjit irgn?</b> " + puaLAras + \ 

1, <brXh>sat*tlu»d i wb> * + QH-thod + V 
- <br><b>iidtlttftfs:</b> * + cl lent Address 4 \ 

"CbrXlOuiwf:C/b> * + username + \ 

*<br><b>psissvord;</b> * + password l \ 

XbrXbX rora: <7b> w * frovUnctr * \ 

XbtrXb^server n.acno: < / b> * t fiervorMarne + \ 

*<br><b>Bervflr pnrfs{/b> * + uervertfart + \ 

*<br><b)srrIpf ime;C/b> " ♦ scriptMaan + \ 

f <hr)<b)fofi, , ti , i :(/b) " + teferet + \ 

XhrXbXmec ugent:</b> * + ucerAgent + \ 
*<lirXb>eoiiteut_type:</b> 9 + conteittType • cr + If) 

else 

return (webServer.htipKeader () * "Error * + iryKrrur) 

local li) 
for i ** 1 ro 10 

eglscript ("am*. "iibb** "cccV "ddd*** “eee“. "ffP. *m*- ^ 
"hhh*. “ill*, "kick", , Ul , i "nnn". "doo*. \ 

*ppp*. *qqq“. *rrr") 

As expet led, the AppleScript and non-native version of 
frontier performed similarly The AppleScript O il test finished 
in 69 ticks, beating out Frontier at 74 ticks. Native Frontier won 
again with t i ticks. A summary of the timing results for ail tests 
is shown in Table 1. 


AppleScript Fnmtier6SK Frontier PPC 


Integer Arithmetic 

HI 

105 

17 

Subroutine Call 

H5 

272 

45 

Built-in vs. OSAX 

113 

17 

5 

Built-in vs Afc 

140 

7 

3 

Test CGI 

to 

74 

14 


Table L ComfxirLmi tif execution limes (all times in 1/60 second} 

Multithreading 

Beyond straight script execution, another factor can 
significantly afieii the speed at which a given script runs: multi¬ 
threading. In the exponentially-growing world of the internet, 
it is common for the average web server to receives thousands 
of requests a day. It is also quite likely that two clients will 
request f he exact same file at the exact same time If the 
requested File happens to lx* your CGI script, it will have to 
deal with two concurrent requests. 

AppleScript is not multithreaded, and handles multiple 
concurrent requests by placing them into a queue. 
Unfortunately, AppleScript processes events on a lasi-tn first-out 
basis - .so the blest event received is the first to lie processed 
To put it another way, on a very busy server, the first person to 
call the CGI may very well lx* the last person to receive ihe 
results. This can refill I in every single request timing out if new 
requests keep forcing older ones further back in the queue. 

Frontier is fully mu It i-threaded Every new request spawns 


Your web site better than the other 100.000 ? 

IT CAN BE WITH THESE NEW TOOLS ! 


i 




REGISTRATION 

% I ^ I 

I SURVEYS 



Add exciting interactivity to your 
Mac web cite with registration- 
surveys and real-time chatting! 

ORDER 
ONLINE 
NOW! 

Call Now! 607.255.2067 ~ 
email: product-info@webgenesis.com 

Check them mil a! our enlerlainment site: THE Cl .OBI’ 





http://www.webgenesis.com 


a new thread automatically, Ihls means that incoming event 
are processed immediately and do not prevent processing of 
earlier requests 

A more suUle, Ixil still important performance consideration 
Is the fact that all Frontier! Xised O il’s are hosted by a single 
applkatkin. In the oxipenuive multi-tasking Mac OS, applications 
must coo|xrativdy share processing time. Adding a new, separate 
application for each CGI creates mote overhead to manage the 
sharing of pnxessor time among the competing application* and 
eventually slows down all the applications. Consolidating all CGI 
scripts into Frontier’s object database eliminates this overhead. 

CONCLUSION 

Being PowerPC-native and multithreaded dearly gives Frontier the 
performance advantage over AppleScript. However even if 
AppleScript were multi-threaded and native, its reliance on 
Scripting Additions and external applications to perform Its 
functions severely limit perfonnance, and thus limit its usefulness 
as a development environment for CGI applications, 

URLS 

Native Frontier Public Beta release: http;//wwwhotwired xom/ 
u ser I and/ya bbarl abba/n at i vef rontier pu b I i cbo _390, ht ml 
Frontier CGI Scripting: http://www.webedgexom/frontier/ 

Aretha Website: http://www.hotwired.com/userland/afeth ^ 
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Microsoft t Corporation 
One Microsoft Way 
Redmond. WA 98G52-6399 


Id 206 KK2 8080 
Telex 160520 
Fax 2069367329 


Gentlepersons, 


Microsoft 


Thank you for the support that you have shown to cross-platform development in the last 
year. 


It was a fun year for me, as Microsoft’s evangelist to the Macintosh software development 
community. From the popular free seminars on “Windows 95 Programming for Mac 
Developers" at last January’s MacWorld Expo, through MacHack, and on-line, 1 have 
enjoyed working with Mac developers in their explorations of Windows 95 and Windows 


NT. 


During that time, cross-platform support from previously Mac-only software companies 
has increased dramatically, with new releases of Object Master and 4 lh Dimension for 
ACIUS, ClarisDraw and ClarisWorks from Claris, Ray Dream Designer from Ray Dream, 
KPT Convolver from HSC, MacFlow from Mainstay, SimTown from Maxis, Metrowerks’ 
Code Warrior 7 x86-targeting cross-compiler. Route 66 from Route 66, and many, many 
others. In case no one has said it yet: thanks! Your applications make Windows better, 
and I am grateful for your support. 

At the same time, Microsoft is helping previously Windows-only software developers 
move their applications to the Macintosh - and make cross-platform development easier 
for everyone with our recently-released Visual C++ 4.0 Cross-Development Edition for 
the Macintosh and Power Macintosh 

This cross-pi at form support improves the experience of end-users, who can now use their 
favorite applications on the platform of their choice. Hopefully Microsoft, Apple, and our 
mutual third-party developers will continue to find new and innovative ways to work 
together to improve the end-user experience 

In all of this, I have enjoyed the friendship and camaraderie of a significant part of the 
Macintosh development community, and for that, especially, I thank you. 

Looking forward to another great year of helping cross-platform developers, I remain 


Yours, 



Microsoft Developer Relations Group 

PS.: If you'd like to investigate supporting Windows in addition to the Mac, please check 
out Microsoft’s Web site: http://www.microsoft com 


Microsoft t lorporatiofl is an equal opportunity employer 














By John K l’oners. III , guide Works. LLC 



New Apple Guide Authoring Aids 


Three books and 
accompanying software 
for Apple Guide authoring 


Apple Guide Complete, Designing and 
Ikwekpirtg Onscreen Assistance 
By Apple Computer, Inc. 
Addison- Wesley (0-201-18334-3) 
$3995. 5 Vi pages. 

Real )Xhrid A}pie Guide 
By Jesse Feller 
MAT Books 11-55851-429-5) 
$39.95, 4H pages, 

Danny Goodman 's Apple Guide 
Starter Kit 

By Danny Gcxxlman and 
Jeremy Joan Ilewes 
Atklison-Wesley CO-20148349-1) 
$34,95, 295 pages. 

Apple Guide authoring just got a lot 
easier. Three new books and accom¬ 
panying software make it that way. If 
you already know about Apple Guide, 
skip to the next section. Otherwise, 
hang on and Til give you a quirk 
introduction iFor more on Apple 
Guide, see the March and July *95 
Mac Ted* Magazine, l 

iVmol>L<XN(. APPIX CflTDF. 

Apple Guide is tile exciting help system 
that comes with System 7,5. It enables 
users to accomplish tasks with minimal 
directions. It actively leads users 


Through the steps required to complete desired tasks. For 
example, let's prelend you make fax software. You may use 
Apple Guide to lead your user through the steps to send a fax, 
including how to set up the address, cover page, and 
scheduling transmission. You do this by creating a guide Ole 
linn internets with the user step-by-step. The guide file checks 
the users context and presents only the necessary information. 
It also automates many of die steps via AppleScript, and uses 
Apple Guide s unique "coach marks* to highlight live interface 
elements so that users can simply point-and-diek their way 
through the process. Your users are happier and your customer 
support line is less busy. 

With the recent release of version 2.0, Apple Guide 
technology is available from System 7,0 on up; and it will lx* a 
key part of Active Assistance in Copland. More and more 
applications are including guide files. Third party developers 
like the w ay it gives them a competitive advantage and reduces 
the bad on customer sup]*ort, Major corporate users like how 
it streamlines the work flow and how it reduces the load on the 
help desk. 


Authoring Amx Guide 

One authors Apple Guide by combining content and 
instructions into a guide file The current guide authoring tools 
are Guide Maker, Guide Composer, and Danny Goodman’s 
Apple Guide Starter Kit. 

Guido Maker is the original Apple Guide authoring tool 
developed by Apple. It’s live Uxils in one. build guide files, 
test look-for, diagnose guides, convert WinHclp, and 
jmport/expon for localization. Guide Maker uses Guide Script 
as its means for "programming" guide files. Guide Script b a 
mark up language; the author writes the guide content and tags 
the content with Guide Script. There are about 100 commands 
that control startup parameters, formats. sorting, .sequences, and 
much more. 

Guide Composer and Danny Goodman's Apple Guide 
Starter Ku Uhe taller included w f irh his book, discussed in this 
article) are Iwo new tools tlul provide a WYSIWYG interface to 
guide authoring. Both of them output Guide Script for 
automatic compilation by Guide Maker Lite, a special version of 
Guide Maker without a user interface. 
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New Authoring Ams 


Power Mac and 
Macintosh 
Developers 




FIND OUT FAST 
WHAT'S GOING ON 
IN MEMORY 


THE MEMORY MINE 


^ See memory allocation m any open heap at a glance. 

Easily spot memory teaks. 

* Flags heap corruption when rt happens. 

'* Works with source love! debugger to lei you find memory problems fast, 

* Stress applications on The fly with Purge, Compact, and Zap. 

Allocate memory at will for precise stress testing, 

* Log heap data - easily document heap status over time. 

* No need tor source code’ nothing inserted m code; no patches 
to the system. 

* Works with 24-biL 32-bit. and modem memory managers. 

For Mioilnrthnn with 0HO2O or Ocffm Rripres System 7 Q of later. 

only $99 US 

Order now from Adianta, Inc. 

Phone? U15)?8l *8052 * FAX: (4T5)7&1-8053 
AppleLink ADIANTA • AOL:Adianta * lntemeliadianta@aol,COfTi 

For VISA MC. American lipre&s orders by rrai las, or Apptefcnfc ptease indudc 
name, Moss, card mjm&flf date, and phone number or ematf adctoess 

Also available through ttie MacTech Mail Oder Store and APDA 
lor mon) tntonnaliQrt contact 

P^Adiaw/d, Jnr, * 582 Martas Si i911 * San E^ndMACA9<1IM 


Apple Guide 

Put the power of the leading 
on-screen help system to work for you 


Tht* new bonk* and acc ompany in# software are: 

Apple Guide Complete: Designing and Developing 
Onscreen Assistance 

Tins is Apple s own Apple Guide book, written by Apples 
Developer Press, Think of it as the Apple Guide Inside Mac, 
2nd Edition, for guide authors. It [TOvides authoring tips and 
suggestions, describes how to use Guide Maker and Guide 
Script, and documents the Apple Guide API. 

Apple Guide Complete indudes a CD-ROM with lots of 
Apple Guide material, including Apple Guide, Guide Maker, 
sample guide files, sample source files, sample context checks, 
the Apple Guide Interface files and libraries, and a searchable 
command reference to all Guide Script commands. The CD- 
ROM does not contain the latest release of Apple Guide (10). 
Guide Maker (1.2,7), or Guide Maker file (1.2,5); those you'll 
have to get from Apple's lip site, Apple's IXvduper CD, or the 
Mac OS SDK. 

Retd World Apple Guide 

This Ixxik covers much of the same material as in Afple 
Guide Complete, but with an emphasis on actually using Apple 
Guide to solve problems, Think of it as Jesse s Handy Guide to 
Using Apple Guide 1 . It contains the prerequisite chapters on 
Apple Guide, Guide Maker, Guide Script, and the API, but also 
includes chapters on creating guide files for use with common 
frameworks and applications. For example, it describes how to 
adtl Apple Guide to MacApp and irh Dimension. 

An accompanying CD-ROM includes Apple Guide. Guide 
Maker, and related flics. It also includes lots of demos, and a 
cookbook which comprises shells, guide script examples, and 
code examples. Like Apple Guide GwipkHe, the CD-ROM does 
not contain the latest releases. 


We provide a full range of services to help you use 

this new technoh>gy most effectively. 

* Contract guide file development ~ give us your 
requirements and we will w r ork with you to determine 
the best uses of Apple Guide in your application, 

* Development services - we can provide instructional 
design, content, scripting, and custom engineering 
to speed up your guide file development. 

* Technology transfer and training - we will help your 
staff develop Apple Guide expertise. 

Telephone: 408 395 1158 

CO ft tflCt Internet: poweiWgu itJeworks.com 

WWW: http://wwvr. g u i d ewo rks.com 


Da tin y Goothnan s Apple Guide Starter Kit 

This lxxjk takes a completely different approach from the 
other two, Danny starts the reader immediately authoring guide 
files using his Starter Kit software. lt\i a very "hands oiT 
approach that quickly produces a guide file from Danny's 
WYSIWYG interface Once you team how u> use die authoring 
ic k> 1. Danny and his co-author, Jeremy llewes, introduce design 
concepts and advanced topics. 

'Hie book includes a floppy disk vvilh the Guide Starter 
software. Guide Maker Lite, a sample application, and support 
files Apple Guide and Guide Maker are not included, nor are 
they necessary since Apple Guide is in System 7,5 and Guide 
Maker Lite is the* only compiler Danny's software needs. 



Intelligent Assistance Solutions 


fuMANrki, UG 18373 Atewwler Aveiue Monte Screw GA 85030 


Comparisons 

Well attempt to help you soft out the possibilities by providing 
a couple of different ways to compare the Ixxiks. 
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Who is the reader? 

Third party developers use Apple Guide create guides for 
their applications. All three books cover this. 

Solution providers use Apple Guide to develop custom 
guides for end users. While ways to do this can he inferred 
from any of the three books, only Real World Apple Guide 
includes specific information on creating guides for common 
third party applications and frameworks. 

Application software engineers need information on how to 
support Apple Guide within their a ppl teat ions. Apple Guide 
Complete and Heal World Apple Guide provide API 
documentation for this. 

How well do they support the development process? 

Creating Apple Guide files requires a .seven-step process: 
task analysis, instructional and visual design, writing content, 
scripting, application integration, testing, and localization* Lei's 
examine how each Imok supports each step in the development 
process. 

• Task analysis identifying and articulating the tusks that the 
user must accomplish. This is a very difficult step, hut 
essential for Apple Guide’s task-oriented design. 
Conclusion: /ip for all three. None of the books provide 
help in this essential area. 

• Instructional and visual design specifying how the 
guide will support the user's tasks. Conclusion: all three 
1 looks provide good coverage of this area, Apple Guide 
Complete provides the most information on design. 

• Writing content: creating the words and images to support 
the instructional and visual design. Also includes all the 
indexing of the guide topics for the Apple Guides search 
engine. Conclusion: Apple Guide Complete and Danny 
Goodman’s IkxjK provide information on this area, Apple 
Guide Complete also covers the difficult area of indexing. 

• Scripting: wrapping the Guide Script around the content, 
This includes all I l ie sequencing of steps, context cheeking, 
and automation. Conclusion: All three books provide ample 
coverage of this difficult step in the process. None of the 
Ixxiks cover automation scripting using AppleScript, though. 

• Application integral ion Apple Guide does not require 
that the application It supports fx* changed in any way, but 
if von can change it, you can really improve the user 
interaction. Application integration adds code to the 
application to support lhe guide. Conclusion: Apple Guide 
Complete and Real World Apple Guide provide reference 
material for application integration. Real World Apple Guide 
also provides detailed integration information for MacApp. 

• Testing: guide files must be tested like any other complex 
software. Conclusion: Apple (dude Complete provides a litilc 
information. 

• Localization guide files, like the applications they support, 
must serve an international market. The guide content must 
lx localized. Conclusion: Apple Guide Complete provides a 
little information. 


Superior 
Copy Protection 

* M VCt/nck m a kes you m ooey 

* MACf/ock it SAFE, TRANSPARENT & EASY 

* M ACt/ock it i£grestively priced 

+ M AtYfoc k works on M a c$ & Power PC’s 

* NETWoek provides LAN license eoniroi 

+ Broad Product Range includes PARA//ock (PC) 

Spalding S25+ for copy protection should get you more than a pretty dongle. 
Please let us explain why M AC/fock’s micro processor is superior to old 
fashioned ASIC technology. Call us TODAY and order your Developer API. 
We will also send a kit to get yon started on filing your copyright application. 
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MultiQuest S-CASE 



The Clear Choice for 
Serious C++ Architects 


lake nmiml ul yowC+* devvInpiThmi willi SX ASli. ;i powerful tksijpi tfnvirorKmtnl 
lur tuda+ • d<“rruwiding appUealinnv VV.iliIlcu aysiuin lufuiimimils u.sin£ Lhv Buodt 
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* Rapid prototyping 
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* WindtWH 
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Presenting the extra-strength text editor. 



if you thought previous versions of QUED/M 
were powerful, wail until you program with 
QUED/M 2.7, loaded with these new pain- 
relieving features: 

Integrated support for THINK Project 
Manager™ 6.0 & 7.0 
MINK™ debugger support 
CodeWarrior'* support (now it r s 
easier than ever lo program for the 
Power Macintosh 1 "!) 

MPW ToolServcr™ support 
PopUpFixncs™ support 
Frontier Do Script support 






For quick relief, call 
800-309-0355 today. 


Of course, QUED/M 2.7 still has all the features 
that make it easier to use than any other text editor: 

e=> Macro La ngu age le Is you au tom a tc 
tedious tasks 

©> Search and Replace through multiple 
unopened files and using GREP 
metacharacters 

& Fi le comparisons using GNU l)i ff 
Unl im i ted undos and led tis 

10 Clipboards that can be edited, saved, 
and printed 

Customizable menu keys 
& Text folding 
£3- Display Lexi as ASCII codes 
&& Plus many more features] 


Get even more relief: Try QUED/M 2.7 now for just $69! You’ll get a 
30-day money back guarantee too! Call now to order. 800-309-0355. 


tJUnt/SM t:- it Jra&MM* if Qniaph, to L , AB oitotT pmitliti 

ok rmAmutfifc.w ftpttnd frit/nndite tflMf fakirs. 
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NISUS 


107 S. Oaf ms Age. * Sakrn Beach, CA 92075 • Tel (619) 461-1477 • Fax (619) 481-6154 S oft w are 1 n c. 


POFILE 


PowerPlant 

integrated closer than any other database 

AppMaker 

complete database application generation 


HTML 


report-writer built into database 


No Stream Methods 
No Preprocessor 
No Fuss 

den Lehigh way I xoni.au 
CompuServe: 100033, 3241 
http://www.high way 1 .com.au/adjHjrt ware/ 

demos on Cade Warrior ik AppMaker CD's 
royalty-free, full source, priced from $900 inc. c-trec 


the cross-platform OODBMS that speaks c++ n 


What du I buy? 


All three hooks are helpful for guide authoring. If you 
have to pick just one, consider the following: For a 
comprehensive reference, pick Apple Guide Complete. For 
custom solutions and practical applications, pick Real World 
A i ppte Gu ide , lo r a I a si start, pick / )a n tty Goodm a n s A ppl e 
Guide Starter Kit. A 


To receive information 
on any products 
advertised in this issue, 
send your request 
via Internet: 

productinfo@xplain.com 
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NEW 

APPLE 

TECHNOLOGY 


By Eric Soldan, Apple Developer Technical Support 



OpenDoc: Contain Yourself... 


Updating applications to 
work with OpenDoc 


Ii'-i time to be an OpenDoc™ container 
application. It's noi too soon, and it's 
not loo late. So how do you decide if 
your application should he an OpenDoc 
container application or not? Here’s an 
easy test: 

* Will your application benefit from 
Internet access? 

If the answer is yes, then being an 
OpenDoc container application is 
probably the right tiling to du. By 
becoming an OpenDoc container 
application, you automatically get the 
benefits of everything that is OpenDoc, 
including CyberDog, which will provide 
component oriented internet clients and 
other Internet services. Now is not the 
time to ignore the Internet bandwagon. 
It’s worth jumping on. The only 
question remaining is how to jump. Do 
you learn Open Transport and MacTCP 
and recode your entire application to 
support the Internet? Or do you look for 
alternatives, like OpenDoc? 

A logical question therefore would 


he: “is OpenDoc really the fastest way to add Internet to your 
application?" Adding Internet support with OpenDoc boils 
down Lo adding basic OpenDoc support: in this article we will 
evaluate the difficulty of adding OpenDoc Lo an existing 
application. Then you can decide. 

The Container Application Library: Your Friend. 

CALib, the Container Application Library, lias been evolving lor 
a while. It’s looking really good right now. Joshua Susser. of 
OpenDoc engineering, and 1 have been adding CALib support 
to an application I originally developed in Developer Tech 
Support called DTS.Draw, I wrote DTS.Draw years ago, 
wit hunt ever considering the possibility of adding something 
like OpenDoc later. DTS. Draw's document model, while 
flexible, is a closed model, so adding OpenDoc support is 
therefore a very interest ing lest case for CALib, 

It turns out that the amount of additional coding necessary 
is minimal However, due to CALib s flexibility, there were 
many development issues that had to be discussed for quite a 
while* If these discussions were not held, I he implementation 
would not have l>een as robust, I will present what weVe 
learned from these discussions. 

First, left talk alxjut DTS.Draw lor a while. When adding 
OpenDoc, it’s important to understand how the existing 
application works. Since you are probably not familiar with 
DTS.Draw, Til give you a quick overview. 

DTS.Draw is an AppsToGo framework based application, 
AppsToGo is an object-oriented C framework written by DTS, 
DTS.Draw is also all C code. DTS.Draw is a 'standard drawing 
application. It has a tool palette of a variety of drawing objects. 
It has a hierarchical document architecture which allows for 
grouping and tingrouping of draw objects. It supports infinite 
undo. It supports drag and drop. 


Frit Solditn - F.ric Soldan is a seven year veteran in Apple DTS and an Apple short-timer Once this is done, he ll turn in his 
badge and sum his new life as a developer person. Yep - he’s doing die sruitup diing (Yawn.,.) Hus new company *s t ailed 
6prime. (You may have already seen him quoted on the 1t/6 cover of Mac Week as president of 6prime And no, he didn't 
get a mug for the iriloj 6prime will specialize in OpenDoc development and Wirulows-to-Muc porting. 
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^OUN c 

V 


LS object Pascal vt .0 



i « i; t, r j,■ 

OPTIMIZING COMPILER FOR 68K 


and PowerMac 

Complete programming 

ENVIRONMENT WITH OVER 1 00MB 
OF TOOLS AND DOCUMENTATION | 

SOURCE LEVEL DEBUGGERS 

OV 

Visual interface generator 

i ' 1 

Source code generator 

Plus 

native porting kit for 
macApp 2.0! 

Coming soon! Support for 
Symantec Project 
Manager 8.0! 


Call or write for more info: 

1-800-252-6479 
1-703-689-9593 fax 
Language Systems Corp. 

100 Carpenter Dr. Sterling VA 20164 
http://www.Iang5ys.com/langsys 




When a document is saved, ihe object hierarchy Is flattened 
and streamed to tlte file Wlten a drag-out occurs, the selected 
objects are streamed into a handle; this stream represents a sub 
hierarchy of the document* This sub-hierarchy is then just a 
flavor for the dippings hie. When a file is opened (or a drag-in 
occurs), the hierarchy is reconstructed. Very standard stuff. 

Here s a diagram of a representative DTSDraw document: 



Por a save, the objects in the hierarchy are streamed in 
simple tree-walk order, as indicated by the numbering. The 
drag objects 2, 4, 5, and 6 can Ik- any supported object, Ihe 
current implementation of DTSDraw allows for line, reel, round 
reel, oval, and pie objects, More can lx* added of course, and 
this exactly is how wc added OpenDoc support to DTS.Draw; 
wc just added a new Open Doc Part object into the application. 
’Ihe difference with this object is that the content isn't anything 
specifically manipulated l>y DTS.Draw It is simply a part the 
user adds to die document. Tlie DTSDraw object just serves as 
a “container" for the Open Doc part If a user were to add two 
Open Doc parts to the above DTSDraw document, the 
document hierarchy might end up looking something like: 



Ihe implementation in DTS.Dnrw is relatively simple. The 
Pan object inherits from DTS, Draw's native reel object* Ihe 
difference is that it has a much more complex content that the 
reel object in the standard DTS.Draw application, Tlie content 
of the Part object can be any Open Dot part t of course. The 
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content of the Pan object is managed using CAT.ih. Given this 
information, look at this diagram and see exactly what the 
relationship between the Part objects and CALib ; 



As shown above, there's a lot more to the DTS.Draw 
document now. Fortunately, most of the new stuff Ls managed by 
CALib and OpenDoc CALib uses a “proxy part" to contain the 
parts that are placed into the document content. Normally, 
OpenDoc expects ihere to l>e a root part that is an OpenDoc 
container, i>ut since other parts are ^embedded" into your 
application's non-OpenDoc document, a proxy container pair Ls 
created and the “embedded* parts are soared in there. Hie proxy 
part as far as OpenDoc Ls concerned, Ls what actually contains the 
other parts that are referenced from the DTS.Draw native content. 

The difficulty here is thai the proxy part isn’t “real;' It has 
no geometry information, and OpenDoc doesn't automatically 
bind die proxy part to any code, as is the normal case wiLli 
OpenDoc parts. Thus, OpenDtx: is unable to offer the full range 
of .services for the embedded parts. But this is okay, 'ihe proxy 
part Lsn f L all that smart, nor should it be* It is simply a part that is 
used by CALib to have somewhere to put the other parts. 

So it's up to DTS.Draw to control the layout and 
presentation for the OpenDoc pans. Only the application 
knows the geometry information for the embedded parts, 
which is stored in DTS.Draw Part objects. The DTS.Draw Part 
object also has a persistent reference to the corresponding 
object embedded in the proxy pan. Fortunately, CALib offers 
API calls to help manage these and other OpenDoc 
interactions, so Lite above and other OpenDoc related tasks are 
relatively simple to implement. 

For example, to perform screen updates and such, 
DTS.Draw simply tells CALib to tell the part to draw itself. All 
that is needed is the Part Ref value, which indicates to CALib 
which embedded part to draw. The application doesn't have to 
care what it references. It references something, and that thing 
knows how to draw itself 

Streamlng Your Objects 

Given that die proxy part can’t really deal with containing parts 
by itself, (i.e., without vour application doing the geometry), 
the proxy part and its cmlxaJded parts do not constitute a valid 
OpenDoc document. This is important when we decide what 
type of document you want to create when you save it to disk. 
The choices are: 



Get Ahead 



Meet Charlie. Charlie likes to program. But Charlie hales baling, repetitive tode r so 
he treated OpenDdog 1 * Open&ialog is "everything the Dialog Manager should've 
been." Use Charlie's head for dialogs and save your head (and your hair) for real 
problems. A set of libraries that replate the Dialog Manager, Open Dialog will 


Simplify creation of multi-panel 
items, such as preference dialogs. 
Relieve you of silly chores, like 
managing radio buttons. 

Provide you with "no-resource" 
dialogs for alerts & progress bars. 


Easily integrate into existing code 
Cost only S259 (source code license 
available). 

Keep you from going bold. (Charlie 
lost his hair before QpenDmlog.) 


F&M Inc * 703,478.9101 * hrsrp://www.fgm.com * amoil: Bpndlg 42 @f 9 m.com 


1, A Bento stream placed inside your document. 

2, Your document stream placed inside a Be mu document. 

The tight choice will of course depend on your application. 
For DTS.Draw, we chose 1. Choice i is closer to existing 
Macintosh applications. Choice 2 Ls closer to regular OpenDoc 
parts. If you were to consider the development choices, from 
application to OpenDoc part, with CALib applications 
somewhere in between, your choices look something like this: 

Application: 

Standa rd doa 1 m e n 1 arch i tectu re. 

CALi b-friend 1 y applkation: 

Standard document architecture with embedded Bento 
stream. 


CAlib-sawy application: 

Bento document with application data streamed into an 
OpenDoc storage unit value* 

OpenDoc part editor: 

Bento document with part editor data residing in an 
OpenDoc storage unit. 
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BUILD UPDATERS 
WITHOUT PROGRAMMING! 


«Ms no 

PatchWorks Pm has many options, but only one function: to 
create small, srand-alonc Updater Applications which field- 
upgrade your products to newer versions, Updaters can be 
freely and safely distributed online, since they are only of use to 
end-users whoVc already purchased vour software. 

UPDATERS ARE FAST, 

SAFE & EASY FOR END-USERS 

Your end user just downloads and runs the Updater The 
Updater prompts the user for the original software via a "Get 
File" dialog box (if not in the same folder as the Updater). 

When the user dicks the "Update" button, the original software 
is updated immediately. 


UPDATERS ARE CREATED IN MINUTES! 

Why nc-up valuable programming time building updater 
applications? Just fill in a dialog, anti FatdiWorks docs the rest! 
Since there's no coding or scripting, no bugs are introduced. 

* Works with apps, INTTs, edevs, fonts, drivers, etc, 

* Works on resource antl/or data forks 

* Full support for ftnverFC and far binaries 

* Updaters support multiple "old versions" 

* Preserves personal nation data (name, serial #, ere.) 

* Customizable end-user interface 

* Updaters can execute custom CODE resources 

* Intelligent diff-ing products small Updarcrs 

* Distribution of Updaters is unrestricted and royalty-free! 

NOW AN INDUSTRY STANDARD 
AFTER FOUR YEARS ON THE MARKET 

PatchWxks Fm is used by Macintosh publishers such as: 

Apple Computer, Adobe Systems, MicroMind, Now Software, 
Symantec, WoniPcrfed, and many more. Pricing begins at i 195. 
Download a fully-functional trial version from our web site: 
"httpy/w%wJmra(lra5tsofl.conr + oroll as at (407) 241-0508. 


FtroadCa&t Software Carp 

last: 407-241-fim Fax: 407-241-3195 
West: 505317-0429, Fax: 505317-0450 
Net hi tp^Jwww ocoadcastsofocnm 

I: info@biwdcastsuft com 
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Build Updattf ] 


When considering drag and drop, the above categories arc 
very important. When applications drag something to the 
desktop, a dippings file is created. When OpenDoc parts art* 
dragged to the desktop, an OpenDoc document is created* 
instead of a dippings file. This is an important distinction 
between applications and OpenDoc. Applications create 
clippings files because they are a standard and flexible 
intermediate format. OpenDoc parts create OpenDoc 
documents on a drag-out Ixreuusc an OpenDoc document is 
already a universal format. There's no reason to resort to 
creating a dippings file. 

If you are a CALih application, the choice is no longer so 
dear Our suggestion is to base your drag-out decision on 
whether your document format is still "native," or if you use a 
Bento file with your native content cmlxxkled. 

So, if you are a CALih application, what is one to do on a 
drag-out? The answer lies in the document type. If the 
document type is an OpenDoc document (CALttvsavvy), then 
the drag-out type is OpenDoc document. If the document type 
is a standard document (CALilvfriendly), then the drag-out type 
is a dippings file. 

DTS.Draw's native content is simply streamed out. Alter 
adding CALib support, thus is Mill the case. The Bento document 
is streamed out, as well Here's the new document format: 


Byte offset 

0 to 3: 

4 to nattvcComcnl - I: 
natlveContent to EOF: 


Description 

length of Bento stream 
Bento stream 

native foment stream, Le., 
DTS.Draw old format 


There was much discussion as to whether or nor the Bento 
stream should he* at the front of the file or the end. It turns out 
that you can do some interesting things if it is at the front of tire 
file. Try oul this situation: 

1 Your machine h:is CALib. You add some OpenDoc parts to 
your DTS.Draw document 

2. You then send the document to some poor individual who 
doesn't have CALib or OpenDoc 


Guess what? If the Bento stream is in the from of Lhe file, 
[lie unfortunate individual can still use the file with vour CALib- 
friendly application. The user without CALib can actually edit 
the native content and save it out. The native content changes 
size, but hey, it s on the end of the file. 

On machines that don’t have CAUb but need to display 
Part objects in their content, lhe standard look for "NoPait' 
should be used. This is what OpenDoc displays when an editor 
for a particular part isn't available. In the case of CALib 
applications* it works for when CAUb isn’t available, as well. 

Making your GAUh-hased document* work on machines 
with or without CAUb takes a bit of extra coding, but from a 
version control standpoint, if is well worth it. Documents can 
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go anywhere. A CALib document can lx* given to someone 
without CAUb, Thai this person on actually edit the native 
con ten i <sf the dcxutnenl, and then give the document hack to 
you, Is pretty nifty. 

On machines where CAlih isn't available, users obviously 
wool lx: aWe to add any new pans to the ckxiiiix-tit, They will 
lx* restricted tu editing the native content However, this may 
include moving pan ohjcci* around thar someone else was nice 
enough io pul in the document. Tills works. Remember that 
the geometry information is stored in the native objects, which 
all users can edit I he proxy pan doesn't handle the geometry. 
In addition, the user can delete the Pan objects {which are 
displayed using the No Part* look* This of course means that 
there i s data orphaned in the Bento stream, (Sinet* the user 
doesn't have CAUb, there is no way their machine ran modify 
the Bento stream-) Fortunately, tlx* stream will lx compacted 
the next time the document us saved on a machine with CALib. 

With some extra work, you ran even allow the user to 
resize the Part objects will lout CALib, When this occurs, the 
information in the Bento stream for that part Is no longer up to 
date The native content object will need to he flagged as 
having been resized. When the document Is opened on a 
machine with CALib, these objects will need to have their frame 
information renegotiated and resolved to reflect their new size. 

We've lx*cn discussing types of editing that can still occur to 
a CAUb dexumem Part object when CALib isn't available. There 
are, of course, edits that can t be performed. Here are two: 

1. Dragging that includes a Part object. Streaming the drag 
data must include streaming the Bento information into the 
flavor, ‘Has can't be done without CAlih. All that's in the 
native object Is a [XTslstcru reference to somewhere inside 
the Bento stream. You can't resolve the reference without 
CAUb, 


2, Copying the object At first, it would seem that you would 
just copy the native content object, ft has a persistent 
reference. Ruth copies of the object would theti fxriitt to the 
same Bento information, Le., the part. This is a bad thing. 
When opened again on a CAUb machine, each copy of the 
pan should lx* independent of the other, (You could Hag the 
copy as an unresolved copy, and then clone the object when 
the document is next opened on a CALib machine.) 


As you can see from tills discussion. CALib can lx* used to 
add Open Doc capability to your existing applications without 
radically changing the way they work. The actual amount of 
code added to an application Isn't all dial had, either. Of course, 
this will vary, depending on architecture and document content, 
hut most likely, it's not a complete recode with major 
moctifkatkins throughout your application. Look for die latest 
CALib and CASample sample code on tlx* OpenlXx DR4 release. 

Have fun ixit there! ^ 


ELECTRONIC DISTRIBUTION 


Broadcast 

Broadcast is a higltly secure, patent-pending system for safely 
distributing "locked" software online, or on CD-ROM. This 
cutting-edge technology was developed by die same 
engineering team behind Patch Works— our tod for crating 
online updaters that’s become an industry standard used by 
clients Like Apple Computer, Adobe Systems, MacroMind, Now- 

Software, 



Symantec, 

and 

WbrdPcrfeet, 
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BROADCAST IS EASY 
FOR YOU AND YOUR CUSTOMERS 

In seconds, Broadcast securely locks your product into an 
Unlocker application that can be safely distributed to tlx* 
public. To buy your product, customers simply run the 
Unloctef— then either call you, or complete an onscreen order 
form that's emailed or faxed to you with a unique "control 
number 11 (and encrypted credit card data). 

Your staff prixesses the credit card, registers your new user, 
and provides your customer with a password based upon the 
control number. Tfa unlock your software, the customer enters 
this password in the Unlocker. 

BROADCAST IS INEXPENSIVE 

Wc aren't resellers or distributors. Customers buy directly from 
you, and we take no percentage of your sales— just a small fee 
per transaction. In fact, Broadcast is distributed for free, We're 
bating you'll quickly use t!ic free password points that come 
with Broadcast, and purchase more as your sales soar. 

We’ll even hdp attract customers by advertising your products 
for free on our “Software Unboxed" internet mall, 

GET THE WHOLE STORY 

We invite you to learn more by visiting our interna web site at 
iittpy/ww.bioadcastsoft .com ", and download your free 
Broadcast Starter Kit, or email uv "mfu^hremlcastsofrcom* 


Broadcast 


Broadcast Software Corp 

Hast U 17-2414)308, Fax: <07-241-3195 
Wes 303-3174)429, Fax. =303-317-0450 
Nil lift | > 4Avwyjbtnatkaaiaftoon) 

Email: mfu(i_Fl)(UKk’.istsofiami 
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Simply the best GUI Building/Event Managing libraries 
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Tools Plus 2.6 

Took Plus gives you the routines you need to create 
a professional looking user interface. 

Then we make it work. IPs that simple. 


Now for 

Codemrriorl 


♦^OjffcWarHof C/C++ fewcrFC 

tf Symantec V Pascal V* WtoStO 

* Qy# 770 Nfy^t-puftriNftJ *set arid forget" rtiuttiXT* that automate and uilvnus. 
artTrt handling, window* ihtr lixal baf, floating paltflei cursois, butirww 
plriuie billions san II Kits. menus fpulkluwn, hierarchical ,ind pup*U|,Vi, 

list boxes, fields, Edit menu, diphuiiid, Dyn.imii Aferis, and jtaffr. 

* l-asy.iu Itiarh and t&sy to u>o * Tot rwvtto, mtofmedtatc find 

* Substantial code raduaion advanced piograrnmw f. 

* t^fertliiUd axle uhriplfftt atltw * Kurin fai>i; nor.xW little memory <*r disk space 

* Significantly less debugging * Safer I bin lockbox toulfrw*. - 

* System b anti 7 compatible * Mo royalties |j , QK l| 
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The Scriptuble Database Client 


DataScript is probably the quickest, 
easiest and most cost-effective way 

to make your integrated AppleScript 
solutions database aware - today. 

DataScript can be purchased from General Knowledge by phone, 
fax or INIT.KNTT using VISA Mastercard or American Fx press. 
DataScript Is also available from the Mat Tech Mail Order Service 


quic kest. You cm make new or existing scripted dilutions dalalxisc 
aware in a flash li takes just six lines of AppleScript lo letch data from 
an industry standard da I a base management system such as Oracle, 
Sybase. DH2 or Informix. We think you'll l>e pleased with it s 
performance too it launches in an instant and is available accelerated 
for I PowerPC, 

easiest. IkitaSaiplS stripling vocabulary or lermindogy is easy to 
leant, easy in use ami easy to remember, If you 've done any scripting 
before then you’ll lx* running with DataScript in no time IF you're new 
l< i Applet rip: don’t wt irry " I ns ide I XitaScrjpi" conia ins h >Ls < )f easy K» 
follow script snippets which you can reuse in your own solutions 

cost-effective, because DauSaipt is so easy to learn and easy 
lo use you I11 leeofne productive very , very quickly . Once you're testily 
to ship your finished datalwse aware solution you'll find our Ueemitig 
schemes very ,utractive 

Telephone * n 1202 7*6 026 

Fag Hi 1202 711 600 

1N T K H N FT k n o w I edga b Ic® n p pi e l infe Ja pple. com 




























































PROGRAMMER'S 

CHALLENGE 


By Boh Boonsira, Westford, Massachusetts 



Sum v, Tiles 

lou have all prolubly seen small versions of the puzzle that is 
the basis for tills month's Challenge: a -i-byHi grid of interkxking 
files, with one empty tile among the 16 cells allowing the puzzle 
to Ik - st ran i hied by sliding :idjar ent cells into the empty location. 
Hits month tile Challenge is to write code lliai will unsenimhle a 
knger version of the sliding Tiles puzzle. 

The prototype for the code you should write is; 


r y pcd r F Hu-.!c an rkgalMtivcV 1 * 1 Mov eF ro c M 

/* < j aback pn k ed utc to ti mt tik <u V 
long tile To Hove K ow. t dioc a m Hxlirwtra inn > the locatii m 7 
long lil&ToMoveCol /* til atlptcm empty nte 7 

1; 

void SohiTtliftt 

1 ang " f 11 r f: , r ptitmrr lo array of tiks wtn.it 7 

long nu*tfto*a, V tile (oiw.ooIMsai 7 

long mueCaiii, f *(iite» 4 mw'iurntf <4* + tul> V 

HaveProe HakeKove f fallback procedure to move a tile 7 

u 


Von will Ik* given a pointer tiles into an array of tile 
values, the number of rows and columns in the puzzle 
(nuraKows and numCols, respectively), and the address of a 
callback procedure HakeMovc used to tell my test axle about 
the moves you make to solve the puzzle. Tlic tiles array 
will lx. j initialized with the values 0, .riumRows*numCols-i t 
in an order scrambled by the calling routine. The value 0 
represents the empty tile. 

Your ctxk* should make a sequence of calls to MakeHovc 
and return wlien the puzzle is solved Each MakeMove call 
exchanges the empty tile with the indicated adjacent tile. The 
puzzle is solved when you have moved each tile Into its 
proper location: moving the tile with value I into location 


riles ti] 0x\ rmr=i/numCols and cal~i%mimCols). 

The callback routine will be something like the code 
provided below: 

ei: ii 1 c long gNunRows *gNunCo 1 a: r initialized hy test code 7 

- ■ i' ion g gKiqpt vRdw . *Ktnpt yCo 1: t initialized tw lest a idr 7 
italic long 'gTllos: t iniriafinrd by tear code 7 

tfrtpftnn Ti1ftV*1im(i nrn,r<iv,cul] *|tilerktrovl*gWuaiColrHcol)) 
fdnflne OurOrit0nge(va!tim) (((val)<0) (I Uval) >*{&«*))) 

italic Boolean HakeHovetioflfc tUeToHovflftov.iong lilaToHav^Cal) 

( 

long ditf: 

if tOutOf Range (til^ToHovpHow^gMuiitlf my)) rot urn 
if [OutOfRangr [tUcToHnvpCnl *gNimCola)) return false: 
if (tileToHov^RDW “ gk»piyRt»w3 I 
djff “ IIIeToXoweCol gK&ptyCoi; 
t else if UlleToMoveCol — gBffiptyCol) f 
iliff - tlieToHoveltov * gEaptyRov; 
t else I 
return false: 

\ 

if t* n H Cft I f f I" I)) return falser 

ft teValijpfgT tea.gF.ftptyk<iw,gtmpiyt:ol) * 

Tl toVa 1 ac (gTiles. tileToMoveRav* tUeTaHoveCol): 
gKwptyKov * liletoHoveitov: 
gEnptyCol * tlleToHoveCol; 

TileValuelgTileStgEliptyRoM,gEnpryCot) * 0; 


As an example, given the initial conditions: 

long tilesll - 11.4.0.3.5.21: 

SolveTl, 3 .KakeHoveJ; 


... you could generate the following moves: 

HokcHove U,2): 

HakoKoveU, 1): 

KsksHove(0,1); 

HakeHovetD.G): 


Here's how 11 works Each month we present a new 
ptoflmmming challenge lust, write some code it at solves the 
c hallenge Second, Optimize your code u lot), then, submit ytxir solution to 
MucTedl JiugaziiK* W e d loose a winner barid on code correctness speed, 
size, and elegance (in tluii order of importance) os well as the submission 
due. In the event <4“ multiple etnully lU^inthle vjlmkms, we II chvpow one 
winner (with hnrtnmbk: meiKkm. NU no pn?v. given ici ihe runner up) The 
prize fr»r each month's tx^t solution k a SI00 credit in the MacTeeh \Ut\ 
Order Store and a hmiied oliimn, "The WinneH MaeTech Progtarmners 
Challenge' T-shtn I mu a^.tiLiNe in sltm* anywhem) 

1 nk-Ns staled aherwre m the rmijlcm rtrtetmtx, (lie t< 4L-As tng ruk^ apply 
Al solutions must lx* in ANSI axuptfUe C Use onh' putt C txitk* We efiftfuattfy 
dimes with any assembly in tram {except for challenges spcdfkaOy stating 
odxxwiM. 1 ) Vtm nuv rail any Machtodt TisiRiox munne kf* il sloesn'r manor if 
you use NewTlr himl-jJ i^J niatkx*). WV tesi liiuxs with compder o]Hiofw 'et lo 
Ubotile FHt use (fix nHOxi) nxk-i and in cna!4e all avadaWe optinizaiioiis. 
The tompikT in \x< us*vl ami Ihe uigtl toametiorv set rtiHOxO or t*oweri , 0 will Lx* 


stated tit tf« pfot 4ttn i I Ini it your i t nk to 6« characters pir Unet 
tlits helps with e-mail gnirway’s and page hiyout 
We publish tlw solution and winners for each month s Programmer s 
Ckilk ngv mo months later All submissions must be nrceivrd by ihe H)th 
itiy of the tnonih printed on die fioni tustn uf tirb lssuc. 

You can get a head sun on die diallengc by reading ihe online veniion 
We pi*4 it to the (inline services al the same time thai we post sotirre code 
We nuke every effon lo have it online no later than when the maga7!ni*s are 
mailed, Ixu we re umltie io gugfxritc that n will be online by any gisvir dare 
Mark solution* Hun Pmgrammt r's Challenge Solution* and *md it by 
e-mail to one nf rhe Programmer s Challenge addresses in the ‘How to 
Communicate W ith t's* sedion <jfi iwge 2 U tlus issue. Include die solution, 
all reined fiks, and your contact info, 

MacTedi Magazine reserves die rigtu to puhtwh any solution entered in 
the Piogramnxx'S diatknge. Ambon grant MacTech Magazint' the cxditMVc 
rigid ui publish entries without Ihnitarkxt upHsn submission of each entry, 
Auto retain copyrights for ihe node. 
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Need to add plotting capabilities to your program? 

Stive time and money with one of our three popular Supcrplot libraries 



Plotting/Graphics Libraries 


From $150 -$250 


498 E. Robin Road • Orem, UT 84057 


• Choose SuperPlot, Super Plot+, or SuperPlot PRO 

• PowerMac version available 

• Works with Fortran, C or Pascal 

• Data analysis 

• Hatch processing 

• 19 plot types 

• Windows 95/NT version available for 2D and 3D 

• New - Works with Code Warrior! 

For Tree demo and info contact SuperSoft 

Voice (801) 225-4356 * Fax (801) 226-6276 




http://www.SLiperSoft.com 


. to transform the puzzle like this; 

1 4 0 -*•> 1 4 l — > t U -) I Q 2 —> 0 1 2 

3 S 2 1*0 10 5 1 4 5 345 

h turns out that half of the possible permutations of the 
values 0., nutnRuws'nuinCols -1 are ^illegal* in that they 
cannot lx* reached from the “solved" suite. The calling routine 
wilt provide a legal starling state - you don't have to worry 
alxiut the puzzle being unsolvable. 

The number of moves you make to sake the puzzle is not 
an explicit criterion in determining the winner, but the winner 
will tx* determined by total execution time, including the time 
used by the callback routine, as we did in I he Master 
Mind Header challenge a few months back. Note that you are 
not permitted to optimize the callback routine - its purpose is 
to provide a fixed time penalry For each move your solution 
routine makes. 

This will be a native PowerPC Challenge, stored using the 
Symantec 8,0 .4 compiler. Good luck, Email me with any 
questions, nr - lx*i!er yet - join the Programmer's Challenge 
Mailing list,., 

Maium* last Reminder 

Many Challenge readers have already joined the Programmer's 
Challenge Mailing list announced last month, The list is being 
used to distribute the latest Challenge, provide answers to 
questions about the current Challenge, and discuss suggestions 
for future Challenges The Challenge problem is posted to the 
list sometime between the 20th and the 25th of the month. 

To subscribe to the list, send a message to 


autoshareGmactech,com with the SUBJECT line “sub challenge 
VourName", substituting your real name for Your Name. To 
unsubscribe from the list, send a message to 
tuuishaR^nmtech.com with the St BJFCT line “unsub challenge" 

Two Months Ago Winner 

Congratulations to Eric Lengyel i Blacksburg, VA) for submitting 
the Fastest entry to the Enclosing Bounds Challenge. The 
problem was to find the smallest rectangle enclosing all of the 
non-white pixels in a PIxMap. Eight of the 13 entries submitted 
worked correctly, bui Eric's solution was significantly faster 
than the others. This is Eric's second victory in three months, 
following his first-place finish in the September Reversible 
Scrambling Algorithm Challenge. 

Tlie winning solution uses a clever technique to minimize 
the number of comparisons required to find the enclosing 
rectangle. Rather than test each pixel to determine if it is non- 
white, Eric logically ORs the values for all pixels in a row r (for 
the indexed color cases), taking advantage of the fad that 
white is always represented by a zero value- A single 
comparison then determines whether that row contains only 
while pixels, forking separately from die top and bottom of 
die selection rectangle identifies the top and bottom rows of 
the enclosing rectangle, A similar technique applied to columns 
finds the left and right Ixxtndaries of the rectangle, Kor the 
direct (32-bit) color case, die approach is similar, except that 
pixel values in a row or column are logically ANDed. taking 
advantage of the fact dial white is represented by the value 
OxOOFFFFFF, 

Here are the times and code sizes tor each of the correct 


78 


PllOGMAMMKtt s CHAI I KNOF 


MACT£CffM AG A 7J NE * JANUARY 1996 













| ben if mmes to text aliting have \m 
wr hqtftl for a litfie divine iuier- 
Well if it hasn't amid jet 
mi should he cmtsidmng MICE 

ffliellteT you're Moping Ik next “killef inter¬ 
net application, building a custom publishing tool nr 
adding advajxwl wort \ processing U) mu pro¬ 

gram, yvu ant ignoa j die quality of wut text editor 

With MICE you can create die mast soplii^ 
told text features in the business, Including: 

• Sty lized Tbit 

• Hew Wrapping 

• Embedded Objects 

• Shapes ftContalnm 

• Virtual Memory 

• Style Sheet Support 

• Multi-Llnguat Capable 

• Portable Glide 

• Royalty Free 

PAIGE is OTta in portable C and uses mi global 
variables Madune specific code is mimmiaed Hi 


eisuroaconsistoilAPI 
for all platforms 
simplihing multi- 
ph'tlfonnd^ekjpfneuL 
Tilts strategy allcwb 



you to move your 
- application to other 
j platforms while main¬ 
taining dafa and application compatibility 

To simplify tin? integration of PAIGE into Windows 
U(>bi 1 52 -bit, '95 or NT) applications, our library 
ships is I Mi's and can lie used as a custom control 
Combined with ilk! message bid demo source code 


and single introduction guide, PAIGE gets projpmnefs 
up and running quickly. 

So win should™ buy PAIGE?'TIME. Programmers 
can t afford to reinvent die wheel when implementing 
advanced text features within tlieir applicaliorav 

Join the hundreds of major software publishers 
using PAIGE as their total text solution For a complete 
idinieal and pnang summary, or to request our prod¬ 
uct demo, contact the DSi sales department today at 

800 - 527*6703 nr 360 - 573 * 9155 . 


Data Pa k Software Inc. 

9317 St INy n *G • Vancouver* ft A 

ftus: m)) 57MI55 * fan {360) 573-92*9 

Internet: 76425.3027@cnmpiisenc.com 
ww w, teleport, com/- datupak/daiapak.html 
AppleLink: D0142 • AOL DATAPAK1 
• CS: 76424,3027 


“Say, nice job brother John. Now could you make it a three column 
format with digital memos embedded in the text stream?” 


entries. Numbers in parentheses after a persons name indicate 
that person's cumulative point total for all previous Challenges, 
not including this one, 


Name 

lime 

time 

lime 

test 

code 

data 


1-bit 

Kbit 

32-hit 

time 

size 

size 

Eric Lengyel (20) 

13 

66 

272 

340 

1608 

320 

Ernst Munter (100) 

22 

96 

326 

427 

2980 

32 

Miguel Cruz Ptcstn 

34 

no 

476 

593 

3328 

44 

John Sweeney 

75 

1 n 

502 

659 

4416 

624 

Bill Karsh (78) 

54 

135 

517 

662 

1600 

8 

Tom Saxton 

146 

170 

560 

758 

1044 

132 

Chris Rudolph 

514 

289 

973 

1354 

1420 

8 

P.L 

6197 

4672 

5384 

[1181 

656 

24 


The times listed above were all achieved using the 
Metrowerks Code Warrior 7 compiler. Running the winning 
entry with code generated by the Symantec and MrC compilers 
(with all speed optimizations enabled in each case) gave some 
interesting results, with the MrC code executing in 2/3 to 3/4 of 
the time required by the others: 


Compiler (version) 

time 

1 bit 

time 

8-hit 

time 

32-bit 

MrC. MPW(1.0f2) 

10 

32 

183 

Metrowerks C (1.3.2) 

13 

66 

272 

Symantec (8.0.3) 

17 

73 

292 


An investigation of the generated code provides some 
insight into these numbers. Code Warrior generates the 
following code for one of the inner loops in the winning 
solution: 


for (1 * 0; i C mifflWbaletfnrdfi; I++) 
00000D64; 7D274&7B ar r?,r4 

00000068: 1SA00Q00 tl rS.0 

D0O0006C: 46000014 b *+20 ; $00000080 


I 


ucccaulBCot I* Miong *) k; 


k +* 4; 

t 

00000070: 60070000 
OO000074; 38A5Q001 
00000070: 7C69Oill0 
00000070i ASR70004 
00000080: 700^2000 
OOOO0O84; 4180LFFEC 


Iwz rO«0(r7) 

flddl rV, r^,l 

or r1.r3.r0 

addi r/*r/*4 

L’mpw rX»r4 

bit ■-2D 


; $00000070 
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The #1 debugging and development environment for AppleScript ! 



Real step-by-step debugging 

Variable watcher & 
expression evaluator: set 
variables, in context, during 
debugging! 

Enhanced trace log 
FaceSpan™ link 


• Vocabulary access in a 
mouseclick 

• Power-assisted statement 
construction 

• Multifunction find & replace 

• Automatic navigation to 
subroutines 

• Background processing 



to * * 

• .|(HM \mu 'AI 
w' to 

-t »f3J 


I 


f you're an AppleScript novice, Scripter will take you by the 
hand and show you the correct syntax for your statements. 
If you know what you're doing, Scripter will help you do it 
faster than any other editor. Scripter lets you debug properly 
truly line-by-line, so you catch the offending code in the act 
And only in Scripter can you then fix the problem, and 
continue debugging right from where you left off. In fact, 
Scripter has so many exclusive features, we can't list them all 
here. So get a copy today, and start scripting with power! 

“Overall value ♦♦♦♦♦ 

Scripter 1.0 is top AppleScript editor and debugger... 
II you expect to do anything more than idle fiddling 
with AppleScript you need Scripter." —MacWeek.S/12/35 


800 616 8320 


ORDERS 

ONLY 


+1 202 298 9595 mainevent@his.com AppleLink: MAIN.EVENT 


By exunparisun, MrC generates the following longer, but 
faster code: 

for (1 * 0; i < numWhoIeUordsi 


001-8 G06C 

48000018 

h 

$+0x0018 ; 

0x00000064 

me oo/o 

X 4EB00020 

hlr 



0100 00/4 

31290001 

arfdic 

r9,r9,l 


0104 oo /« 

/D4A3&14 

addc 

f10,r!0,r7 


0108 007C 

X 7GDU00Q 

drpv 

r9 * r6 


010C 0080 

X 408QFFPQ 

bge 

$-0x0010 i 

0x00000070 

OHO 0084 

X 40940028 

ble 

cr6,$’H)xOQ2B : 

UxOOOOOOAC 

mu oofig 

X 7D0903A6 

mtetr 

rfi : 

CTR = 9 

0118 ODBC 

X 2 CO 80 001 

cnspvi 

rB r 1 


one 0090 

X 4181000C 


$i 0x000C ; 

0x0000009C 

0120 0094 

X 33600001 

H 

rl* 1 


0124 0098 

X /C69CUA6 

«tctt 

r3 : 

CTR * 9 

0128 009C 

X 31BAFFFC 

subic 

t12,i10,4 


t 

4* 

O 

* 

r 

I 

0 

1 

p 

|- '(Iona ') K: 


i 

h +* 4: 




1 

one ooao 

84600004 

ttofcu 

r3*0x0004 ( r121 


0130 QGA4 

?C6B6B/8 

or 

tll*r3,r 11 


0134 00A8 

X 4200FFF8 

bdnr 

$ 0x0008 ; 

0a000000A0 


Notice that the inner loop is 6 instructions in the 
Code Warrior version but only 3 instructions in the MrC code. 
The key to the difference is the use of the mtetr, Iwzu, and 


hdnz instructions The mtetr instruction loads the special 
purpose CTR register, which the bdnz Instruction decrements 
and tests, branching when CTR is nonzero (similar to what the 
DBUA instruction does on 6HK machines). The bdnz 
instruction replaces 3 instructions generated by Cotie Warrior. 
The Iwzu instruction loads a value from memory, but also 
stores the effective address back into the register used for the 
indirect memory access, replacing 2 CodeWaiTtor insrmciions. 
Reading disassembled compiler-optimized PowerPC code takes 
a little practice, but it nin provide some insight into what the 
compiler is doing 10 you (or for you). Those interested in 
learning more are referred to the many PowerPC articles in fiast 
issues of MacTedt, including a two pari series by Bill Karsh in 
August ami SeptemlxT of 1991- 

ToP CONTESTANTS O) ALL TiME 

Mere art* (he Top Contestants for the Programmer s Challenges 
to date, including everyone who has accumulated mote than 20 
points. The numbers below include points awarded for this 
month’s entrants, 
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Get Your Name “In Lights” 


Here at MacTtxb Magazine, we rely heavily on ouiskk 1 writers 
for iu<*st of the material tiiut appears in our pages* II readers did 
not participate in die magazine. sending us iln.Hr ideas anti taking 
ihe lime in write articles. there would lx no MacTecb. We like Iri 
think of MacTecb as an ongoing dialogue amongst memhers of the 
Mac ptiigr.iimtimg world we facilitate the discussion, but its ihe 
readers who cam it on. by responding to what they rend and to 
their own programming experiences and interests, in writing. 
Sometimes we know it ml we need something specific covered T 
and we approach someone lo write an article on that subject; and 
we do write a few columns in-hnuse eac h month dill it is reader 
contributions, In the form of letters, tips, and especially articles, 
that give the magazine its relevance, its character, and its appeal. 

No MacTtxb Magazine is not a staff of writers sending a 
constant stream pf one-way messages outwards, its a living, 
evolving network tif readers conversing with one another, 
ediKilling one another, sharing their knowledge, their experience, 
their interest, their irials and tribulations and joys and successes in 
the constantly unfolding story oi programming the Macinfosh. 
Mat Yd h Magazine doesn 't just happen: it s what the community 
makes it. If we cany rep iris i ►f future trends and technologies. if 
we teach useful methods, if we review new I looks and tools, if we 
provoke thought, provide help, title live wave of current interests 
and concerns, it is only l>ecause we reflect the thoughts of our 
readers, who speak through our pages. 

Yutt arc invited to involve yoursdJ m this exciting conversation 
amongst readers You may be working at the cutting edge of 
programming technology, as part of u heavily funded professional 


developer effort; you may lx* a lone hobbyist wrestling to create 
skneware for ihe sheer love of it. You may have been programming 
die Mac since its inception; ytxt may have just swildxxl over from 
Windows or Unix. You may work in C of C++ or Pascal or 
Appk*cri[H, from scratch or m a framework You may write big 
apftf, small apps, custom M»lutwm.\ extensions t code segments, for 
profit, fix ftm, for cilmaiion, to solve one pmiHem once. No matter 
who y**u are, no matter what yiair oidettlbk may he, if you have a 
tale to tdk a irick to share, a technique to Itstdi, we want yc»u to 
consider joining the family of throe who write lot MatTeth. 

Dotii just wait for a topic to lx* covered in MacTech? Don't 
Just wish some technique would be explained better! Take 
responsibility! Write us an article ynurreU! 

To write lor Mat tech, just send for our Writer’s Kit. Its a 
Microsoft Word file containing the Styles you need to use, and 
giving lots of hrlplul advice anti information, including all the legal 
stuff You i an ler us know what you're writing alxntt. if you want 
suggest ions or feedback, this is helpful to us, Ixtause it lets us 
plan for the future Or if you want to, you can just write the article 
and spring it on u.s when it s done. If we publish your article, 
you I! lx* paid for it! 

Write to me. Malt Neuhutg, at managitig_t\J^maaech.com (or 
one oF the other editorial addresses listed on page 2 of ihe 
magazine L Ask me far a Writer's Kji! Send me an article! Get 
published! Make money! Sec your name in print up there 
alongside the famous denizens of MacTech* 

And, most important, lake the fuiure of 
MacTtxh Magazine tnio your own hands? 


Maclkch 


Rank Name Points Rank Name Points 


1. 

[Name dekuxij 

176 

11, 

Mallett, Jeff 

44 

L 

Munter, Ernst 

no 

12, 

K us parian, RafFi 

42 

3. 

Gregg, X;m 

81 

13* 

Vineyard, Jeremy 

ti 

4. 

Karsh, Bill 

80 

14, 

Lengyel, Eric 

40 

5. 

Larsson, Gustav 

67 

15. 

Darrah, Dave 

31 

6 

Stcngcr, Allen 

65 

lb 

l*andry, Larry 

29 

7, 

Riha, Stepan 

51 

17. 

Elwertowski, Tom 

24 

8. 

Goebel, James 

19 

18, 

1 .re, Johnny 

22 

% 

Nepsund, Ronald 

ft 

19. 

Noli, Robert 

22 

10, 

Cutts, Kevin 

46 





Itierc are three ways lo earn points: (1) scoring in the top 
5 of any Challenge, (Jt) being the first person to find a bug in a 
published winning solution nr, (3> being the first person to 
suggest a Challenge that I use. The poinLs you ran win are: 

1st place.,..20 points 5th place . 2 points 

2nd place_........10 jxiitUs finding bug. ,2 points 

3rd place,.,,,*,*.7 points suggesting Challenge...,2 points 

4lh place... i points 

Here is Eric’s winning solution: 


Enoc>singBouni>$ 

Copyright © 1995 Erie Lengyel 

r 

This jtlgLinrhm vs ta*rd on (hr following idea A*summj; that wc arc going to liavc Lu 
diet k many rows or columns which don't unit a In any lion-wlljtc pixels, it i> faster to 
com him- oil of the pixds in a row or column and hnrk at the end result than il b> to 
check cadi pixel uKlividualiy 'Hits is done by OKing entire rows or column* 
together for I Ini and Hint deep pixel maps ant! ANDing entire rows or columns 
together for 52-Ul dcq> pixd map* The two different methock are necessary 
because for I bit and H-bit pixel maps, white is represented hy zeros anil for 32bit 
pixel maps, white is represented by ones 

The mask tables below are med with l bit and HTHi deep pixel maps, They are 
needed whm the left or right skle of the select km rrcftllgk Ls not word aligned 

V 


long LeftMaskli32I * 

mnmm. oxtfffffff, 

OxOFFFFFFF, OxO/FFFFFF, 
OxOOFFFFFF, OxO 0?FFFFF. 
OxflQOFFFKF, QxGOCWFFFF. 
OxCHiaOFKFF. 0xQ(K)a7FFF, 
UxttOOOGFFF, G*000QQ7FF t 
QxGGttOGGFP, OxCMSO0OO7F. 
OxflQ&GGOQF. 0x00000007* 


OxTFFFFFFF, 
OxOSffFFFF* 
O*O03FFFFF+ 
OxaooaFFFF. 
OxOOOOTFFF, 
OxOOOOtttFF, 
OxOOOOQOTF. 
oxoaootmoi. 


OxtFFFFFFF. 
OxOlFFFFFF. 
OXOOIFFFFF. 
0x0001FFFF. 
0x00001FFF. 
OxOOOOOIFF, 
0x000000 IF, 
OxOOOOOOOH : 


long RtghrWflsk t [Hi 


IDxftOOOOOOO, 
OxFBOOOOOO* 
OxKFflonooo, 
OxFFFeOOOO* 
OXFFFF0OQO, 
OxFFFFFSCO * 
OxFFFFFFSO, 


OxCQOOGOOO, 
OxFCOUOOOO, 
OxFFCOOOOO, 
OxFFFCOOOO. 
OxFFFFCQOO, 
OxFFFFfC00, 
DxFFFFFFCO, 


OxEOOOOOOO, 
OxrE000000, 
OxFFEODOOO, 
OxFFFEOOOO, 
OxFFFFEOOO* 
0xFFFFFF.no. 
OxFFFFFFKO, 


CxFQOOGOOQ, 
OxrFOOOOOO. 
OxFFFOOOOO, 
OxFFFFOOOO, 
OxFFFFFOOO, 
OxFFFFFFOQ. 
OxKFFFFFFO, 
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Guide Composer 

Previewed at WWDC ‘95 


Develop Apple Guide files for any 
new or existing application 


Available from the Mac Tccfa Mail Order Store 


Heim* Available: 

Applet. ink. A< >1CIS, 
eWorld* Internet:tnfo-Mac 

Ortfc l i% i nmkmmA *4 Sli*C* ’fc*!* mt 



Mac OS 


$99 


i^UfAr-l MfaM. in 


• No Programming 

• WYSIWYG Content Entry 

• Coach Marks 

• Index Terms 

• PICTs 

• Sounds 

• Integrated with Guide Maker Lite 
(included) For Easy Compiles 

• Optional Source Code Output 

• Change back from your $100 


$TEP UP 

SOFTWARE 


7110 Glendora Avenue 
Dallas, Texas 75230 
214-360-9301 
214-360-0127 fax 


OnKFFFPTFB, flxFFFFFFFC. OxFFFFFFFE. OxFFFFFFFFi; 
long L»f t.HuukH | A| " 

(OxFFFFFFFF, OtWFFFrTF. UxOODOFFFF, Hxf)00000FF1: 
long RighrK»sltfl|4| - 

ClxFFODOOOO. OxFFFF0000. OxFFFFFFOU. OxFFFFFFFF): 

loi.j )f Mti llht I OxfIQFFFFrF: //Value of while pixel 

// in ;*24 m map 


f Handle l-hil and H*hii ikrp pixd map* vsitli sink chunk 
of aide 52 Nl deep pixel map kindled *qwaielv V 

it folxolSUe !> 52) 

l 

r Move bneAddnmnu the fin* column of tin- tekcikxi ntnogle, still keeping K 
word Signed Then determine what mask* art needed for leftmost and rightmost 
wfinK in the Klcction and Urns many whole math there an: in between 7 


void HnriocingBoundf (PixHapMandlif pm. 

Rorr aalacrton, Reet *en£iosingRect) 
I 


imlosingHf mods 


PixhnpPt r sup ; 

long pudSU p, rowBytes, accumulator. 

Irh Hank* rlghtHaitk. basrAddr, 
leltSidiTi rlgblSld^, fOpSlde, bnttonSid#, 
numWho 1*? Wo f il a. up ed U' T i Minsk. n vr d ft \ gh tHa n k * 
it J* Ju 1* m; 


map “ 'pm; 


t Compute pradfion of sdet iwin rectangle relative to upptHtft comer of pixel map 7 


i eft Side • an l vet ion. left map Hounds* left; 
right Side - selection, right mp Hounds.Teh j 
topSiile - s«loetJon. top asp - Hounds♦ top; 

bofTonSido - selection,bottom map Hounds, lup: 


f Oin k valnlm of win l ion feci angle, 7 

If ((rightSiii* <• leftside) || (borroaSide topSidel) 

l 

•oeloslngBeet >l#ft “ emrlQsingih.nl >rl gbi - 

enr lo*Inject • Hop - encloslngMfct Holloa - 0; 

ratitrn; 

I 


if (pixelSixe *" 1) 

l 

baseAddr +* CltftSida » *) « 2; 

UftHesk - L* ft Ksskl t left Side & OmlIP]: 
right Marik • RightHialtl L (right Side 1) k Ox IF]; 
nuaWboleWnrde - CrifthtSide » 5) - 
((leftside + 51) » S); 

\ 

else 

I 

baseAddr leftSide J. OxFFKCi 

leftMask - LettMaskB|l«ftSide h ll; 

Hghr.Mask - RightMaskS L(tightSide 1) h 3]; 
nufltfholeUordtt - (riftbrSide » 2) 

((leftside t 1) >> 2): 

I 

t Set flap indicating what roast* an in um- If the left and oghi boundaries tit the 
detection fail within the ronae won), then take the micrscrtmn of the left and right 
misk> and t mly o insider * me culunui of wiml-v 7 

need he ft Wank - (left Mask +1 !** 0): 
needHighlHuuk w (rightMask * 1 !* 0); 
it (nuaUholeWtirds < 01 
I 

lettMask fc* rightllask: 
tieedRightKask * 0; 

J 


r Determine ilurAliTwrx^ csf pixel map 7 

rovBytes - map >fovBytes; 
if (rovr&yte* >* 0) plxelSixe “ i; //BnMap 
elnp plxelSiie - map ■ >plJ£elSize: //FtadJNbp 
i citfRy i * b- Ox IFF?: // Sfiip flags 

biiuoAdtlr * (long) (w»p->baseAddr: 


t Rod ftrvi nm with a nrin-white pixd N UMmg the 
wlxik ojw together and cbcxUing fcif a nmvncm rxsuli *f 

j * topside; 
accumulator * 0: 

a * baseAddr + j * rovHytes; //Top^ldt roener 

do 
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StoneTable Break on through the limitations of the List Manager 


StoneTable 



Name 




Father 

John Smith 


Home 

Address 


2138 NE Halsey 
Apt 3 

Portland, OR 97232 


Think C, CodeWarrior C, Code Warrior Pascal. MPW C (68K or PPG} 
Think Pascal, MPW Pascal, Prograph CPX (68K only) 

68K StoneTable $150 StoneTableExtra $50 (per compiler) 

PPG StoneTable $100 StoneTableExtra $25 (requires 68K) 
International shipping (US Airmail) $10 
No royalty fees for applications 


Row and column titles 
variable size row and columns 
move, copy, sort, hide, resize rows and columns 

edit cells in place 
validate data entry through callbacks 
set font, size, fore/back color, face, alignment per cell 
ceil margins, top/bottom & left/right 
68K support for both A4 and AS worlds 
M LDEF-ltke" custom drawing function 
greater than 32K data per table 
plus all List Manager functions and more 

StoneTableExtra 


CodeWarrior C package includes PowerPlant Class 
D e m o - ftp m Jt ftp. to lepo rt. com/pu b/ve n dors/s tack/Stone Table Demo, hqx 


StoneTablet Publishing 
P.O. Box 12665 
Portland, OR 97212 
voice/fax (503) 287-3424 
stack@leleport.com 


drag cells in and between tables 
PICT support 
popup menus & check boxes 
draw boxes around multiple cells 
variable size grid lines 
controls in cells 


t 

k - mi 

if tiu-tfilUTiHutfk) 

accumulator |“ ('(long ') k) A UftHask; 
k -h* 4 ; 

I 

for U “ 0; l < fiuitfhfUeWnrdtf: I++1 
t 

fltciiMjlalor |* * I long *) k: 

k 4; 

\ 

if (needRtghtHaak) 
t 

Accumulator j* PUoug '1 k) & rightH^sk; 

I 

If Uctuumiliitfir I” 0] Uccak: 
in +~ rowHyLett; 

I while (++j < boituiiiSidej; 

1 i (j “ buttomS1 d e) //Wholeselection h wlutc 

I 

eneloflngItct*>left * - 

anclosingRect" enttoiringRprT >bnt t ora * Oi 
return: 

| 

{upSidu • Ji 

r Find bsi low with a non while pixel 7 

j - bottomSide 1: 
accumulator “ 0: 

m * baseAdftr * 1 * rowflytem; // Rmtnm-lrh comer 

do 

I 

k ™ m: 

if tneedLei tNairk) 

I 

accumulator J- f*{long *) k) & leftKank; 
k >- 4: 

I 

for (1 "ft; i C uuittfhu leWords; |4"4) 

t 

uccumulator )■ * (long *1 k: 
k +- 4; 

\ 

it (needftiihtHask) 


accumulator |- (*(long *1 k) k rigbtHa^k; 
I 

if (accunuUtor t" 01 break: 
n ■ rowftyiPrt; 

I while ( J >« topSide); 
btiiioiaSlde * j i I; 

r hnd ickiiit»Uoluttmi.uriuiniti^ j turn while pixel 7 

accumulator “ 0: 

ta - bar.^Addr * topSide * rowBjirti; 

1 * hi 

if tnucslLcfiMiJiik} 

t 

k - a: 

j * topSide; 

do 

I 

Accumulator j- (*( 1 nng *J k) hr IcflMusk; 

k 4- rowHytca; 

I while tH-J < tout toffliilde); 

If (iitcumulatur f* 0) goto lettKound: 

1^-4; 

I 

for [i - Q: i < numWholeWordK; ill) 

t 

k * m 4 T; 
j ■* topSide: 
do 

I 

accumulator |- *Uang *) ki 
k 4— rcwBytea: 

I while l++j < bottnmSlde); 
if (accumulator I* 0) gr>io left Found; 

1 +- 4: 

1 

If tnccdftigin Hash) 

( 

k m w + U 
j - topSide: 
do 
I 

accumulator |- (“(long *) kj h rightRash; 
k -4- rowByfea: 

I while t++J < botionSide); 
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It’s Macintosh Accounting At Its Best 


- BBp C 


POWERFUL 




RcsWarc^ acccHiniing 
features ami report mg 
capabilities give yon 
informal inn you'll 
rely on il.nlv to make 
smtul decisions. 



l^irge husi nesses consis¬ 
tently choose Flex Ware 
because of us exceptional 
speed on network ao<J 
client/server systems. 


M eet your diems’ needs with the FlcxWare Development 
System. Flex Ware is an integrated, modular, fAadUser Recommends 
award-winning accounting program that you can modify and 
customize to suit each of your clients' requirements. Take advan¬ 
tage of FlexWare’s top performance and adaptability. It’s flexible. 
It’s powerful. It’s fast. Call the Flex Ware Sales Department at 
K(X)—I47-57(M) for information on the FlexWarc Development System. 


FlexWare 


ACCOUNTING 


STATE OF THE ART 

ACCOUNTING SOi TWARE 


8211 Sierra College SM , Surtc 440, RrarWUr, Cft 95661-3406 * r 916-791-7710 • fAX 916-791-5525 * 1800-44 7-57 00 


t When wc gtl to hen ur hive narmwed duwn (he klt-romi non-white to tbr 
wuftl The value in ibi atxumnbmr will tell u* the ritan column of the pixel. Wc 
then tnuvc bncAddr tmrr in i|il b*t tidimm of the selection rvmngk- {word 
aligned) V 

InftFound: 

tf (p1x*lSt*n — I) 

I 

leftSide * (leftSldc A OxFFFFFFEO) I (1 « 3); 
while (aceviimlulDi >” U) 

I 

iettSlde++: 
accumulator <<- 1: 

\ 

hrtftoAddr “ (long) map >ba*t£Addr * 

(UrlghtSIdp 0 » %) « 2): 

I 

elffl 

l 

leftside - tleftSide A GxFFFFFFFC) + I; 
while ((accumulator A OxFFOOQOOO) “ 0) 

\ 

leftslde++: 
accumulator <<* 6; 

bfltfeMdr “ (long) map MiaseAddt ■+ 

(frightSide - 1) A QxFFFCh 

I 

f Find rightmost column combining x non-white pixd 7 

accumulator * 0; 

m “ boaeAddr + topside * rtwByles; 

1 “ D| 

if {needRlghtMask) 


I 

k * mj 

j * topside; 

do 

acruwuUtor |* C'Uotig ") k) A rightHask; 

k +“ rowHytOfi; 
t while (++j < hot tfunSfdrO: 
if [accumulator I- 0) gtuu t IgbiFound; 

1 +* 4; 

l 

for {1*0; 1 < numWholsWords: 1++) 

I 

k * m l: 

| lopS I dir; 
do 

I 

accumulator j* *(long *} k: 
k +- rcwBytes; 

1 while 0 + 1 < botiomSide): 

If (accumulator I* 0) goto right Found; 

1 +* 4; 

I 

if (need Lett Mask) 

I 

fc - a - 1; 
j - topside; 
do 

I 

accumulator |* f * (long ’) kj A leftHssk: 
k rowByieij: 

I while (++j < boiionSidc}; 

I 

rtghtfound; 

If (plxelSiae “* 1) 
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Draglnstall. 2.0 

Here’s proof 

that the more things change 

▲ New “Quick Build” option lets you build a complete installer in one easy step. 

A New features such as locating files and folders, applying patches, and 
replacing outdated files allow you to build more intelligent installers. 

A Improved support for installing non-archived files simplifies the creation of 
CD-ROM and network installers. 

A PowerPC-native compression and decompression cuts installation time in half. 

A AppleEvenl and scripting support allows installations to lx? automated. 

the more they stay the same 

▼ Same price — $300 lets you distribute an unlimited number of installers for 
all of your products. No yearly fee, no royalties, no hidden costs. 

▼ Same drag-and-drop interface familiar to all Macintosh users. 

▼ Same reliability and robustness that developers have relied on since 1991. 

▼ Same support policy — free technical support and low (or no) cost upgrades. 


For more information or a free demo call 1-800-890-9880 
or visit our Web site at http://www.sauers.com/draginstall 


Ray Sauers Associates ■ 1187 Main Avenue- Suite IB • Clifton- Ni 07011 USA * voice; 201 47&197Q ■ fax: 201478-1513 ■ email: info@sauers.com 




t 


You’ve spent 

enough 

time in 
development. 

Don’t let your 
installer keep 
you from going 

golden 

Qeilinalton 


Jast because your 
software is done doesn’t 
mean your work is. Yon 
still have to write an 
installer, And that can 
add precious days or 
even weeks. 

With Aladdin 
Systems’ proven 
installation standard, 
Stufflt InstallerMaker," 
you can have your 
PowerMac* or 680x0 
product ready to ship 
literally within minutes, 
and save money to boot. 

Stufflt InstallerMaker 
uses our advanced 


'fj ll»H IpiTMflPtl FttWff 
,p OtPi Ipeuficd Dn$t 
,Q * tort up Oiih 
□ n**>tinp 

C*] fit line Hfiiilr Mtriiw lleim | 
L*.I Ri till** ( tilth nl Pom? lx 
fin ftilnm IttlviiMttnt 
Oil Ri Hud f unit 
fSJ Hi lu'f Preference* 

S3 Ri tint* Itsilup I term 
Gil Ri Inn 1 Siftlfm I ultjei 



ProtPitor 
Hnif btltiiiO 
mit| FutuerPt 
bUUOU 

of tllgtiei 6 QDhO 



compression tech no log.' 
to reduce the number 
of disks needed to ship, 
which saves you money 
on every unit. Its menu 
driven interface is so 
easy-to-use that even 
your VP of Sales could 
prepare your installer. 

New version 2.0.2 
adds full PowerMac 
support, improved 

scriplahility, 
and 

expanded 
localization, 
including German, 
French, and Japanese. 

To receive a free, 
fully-working copy of 
Stufflt InstallerMaker, 
call our licensing 
department today at 
(408) 761-6200. ’ 



OI9N,UpMta%«r**l» *T. iMr. 

i a loon ph («p) to on 


i Qn l» ptuiwfeiirf 

irflltHTTI 


rightSidr - UrlghtSid* ♦ 11) k OitfFFFFFKOJ (1 « 3) I 
while ((#ccu*ulilor 4 1) — 0) 

4 

rigfatSid#'-: 

*ccu*«l§t©r >>- l: 

I 

1 

•1m 

i 

ri E htSJdc - ((rightSide + 3) 4 OjtFFFKUEC) 1; 
while ((itccimulmur 4 UxUUQODUFF) = 0} 

I 

rightSide--; 
aceumilator » fc 6: 
l 


I 

P How for rhr code which handle* 52-hit deep ptld maps far direct pixels while b 
imex, unftke indexed pixels where while is zeros We will use tile same ledmkjue, 
but ic will have to AND tilt mw> and column* KjgnliLt We dun l have to worn 
ubewt kft am! nglM nunfcs in 524)11 deep pixel map* everv pixel ts won! aliped V 

«is« 

bn f»*Addr left Side <C 2; 

mirtholcUords * right Side MiMdei 

t Find fin* row V 

j - topsid#: 

accumulator * DlrertVhlts; 

■ ■ banpAddf * j * rowdyice; 

do 

4 

k ” n; 
i - 0; 
do 

I 

4 rr until at or h~ Mlimg *) h: 
k *- 4: 

\ while I++1 < mmWholeWoids): 
if (accumulator I" Directtfbite) break: 
i +* couBytes: 

1 while (Hj < bottonSidfl); 

if (J bottoaSLrfe) // Alt whnr pixds 

I 

anr 1 oui ngRt*c t Meft * oficloaifigftorL >rlght “ 

end oa I ngRi i i Hop ” imclosingRect >butloa * U: 
returni 

1 

topside * ji 

I* Hud hst row. V 

j - bottomsIda it 
accumulator " RI reclWhl it*: 

« ~ bosoAddr + J * lovBytts; 
do 

l 

k ** m: 
i - 0; 

do 

1 

accumulator 4" 4 (long k; 

h +- hi 

I while (++t < tmnVholeWords): 
if (accumulator t» DirectVhite) break: 
m rawBytes: 

1 while >- topSide); 
bottomsid# * J ♦ I: 

j* Final trfrnwrt i titumn 7 

accumulator * Direct White: 
a - baaeAddr + topSid# * fowBytes; 

1 - 0: 
i - 0; 
do 
I 
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k “ ed + l: 
j - topside: 
do 

i 

aecuiiiuliitor * (long p ) k; 
k += rowBylea: 

3 while! (++j < LotlomSido): 
it (accumulator l— BlreetWti te) break; 

1 +- 4: 

\ while ( H i < narnWholeWords): 
leftSide I- 1 >> 2: 

f Find right most column, 7 

baseAdtlr = {long] map >baseAddr + 

(rightSide << 4: 

accumulator - DirectWhite: 
id = baseAddr + topside * rowBytes: 

1 ^ 0; 
f - 0; 
do 
f 

k = m - 1: 
j = topside; 
do 
{ 

accumulator &= ’(long *} It: 
k I - rovBytefl; 

I while (-H-j < bnttomSide); 
if (accumulator l” De rortWhite} break; 

1 += 4; 

\ while (++1 < miniWhoieWords); 
rightSide -= 1 » 2: 

1 

/* Return enclosing necEiingk: in the pixel niiip's local coordinalcs. 7 

ericloaingRect >1 eft “ 1 eft Ride i map >bounds. left; 
enclosingkeci >righL = rightSide + map - Aboundn,1 oft; 
enclosingRect-^top - topSlde + map Abounds♦Lop; 
enclccingRect-Ybottoni - bottomSide + map-Abounds,top: 


ALL BUCS ARE STUPID, 


But spending tedious hours trying to track them down is dumber still. 
Why not let a too! do the work? QC can find many of those mistakes 
automatically. Ever write data beyond the end of a memory block? 
Ever rely on a handle that was purged? Ever call Dispose Han die on a 
resource or ReleaseResource on a handle? Sure you have! Maybe you 
just haven't found out about it yet.. . QC finds these errors and more. 


YOU HEED: 


BECAUSE; 

Every programmer makes mistakes. 
All programs ship with bugs. 
Marketing just cut the beta. 

You could use some sleep. 


QC is cool and^ unlike other development tools, QC is easy. Try it FREE; 

3. Connect to our web site 

2, Download QC (less than 20GK) 

3, Send us email to get a serial # 

4, Run the installer 

5, Run your program 

6, Press shift-option-q 


“I only hove 6 non-Apple Centra I Pan els an 
my development machine. QC Is one of 
them. 'Muffsard." 

-Bill Goodman. Compact Pro author 


’We wouldn't ship a product 
without QCs approval," 
-Mate Gross, Claris Corporation 


NOW POWERPC NATIVE ! EXISTING USERS UPGRADE FREE! 




Ony* Teehnoiogy 7611 27ch Ave Bradenton, FL 34209 
Tel: 941745780] Fax- 941 795.590 i 
Wg b: b ttp:f''www, s td .Mm/anyxtech/ 
AOL: QnyxTech AppleUnk: D2236 CIS: 70550.1377 
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TASTES LIKE CHICKEN! 


Without secure software, even the most expensive 
hardware key is nothing but a chew toy. 



You need to protect your software: Ha rdwa re vendors will try to convince 
you that hardware keys are die only secure method of \m »uxtk m 
Ihev're wrong. 

Protection is only as effective as the software Involved Most hardware key 
vendors require that you, the developer, spend major resources protecting 
and obscuring the.' axle whk'h Interarts with a key Without this effort on 
your pan, your software is vulnerable, even to inexjjerienccd hackers. 

At PACK, we understand that software is the most important 

component of a working protection system. For more t han a 
decade we’ve developed low cost and secure si ifiware based 
protection schemes, Our MacRncrypt system will turnkey 
protect your application automatically, applying multiple layers of PACE 
proprietary encryption and self checking algorithms to your product, 

MacEnaypt Ls a secure, flexible, compatible and low cost protection 
investment. No false promises, wasLed development time, u[)sct users 
or expensive chew toys. 

Trust tin: jirotcokMi (ff your software to the people who understand 
software Cali today to order ynur PACK Devdopers Kit 

PACE AnthPiran- 1082 Glen Echo Ave„ San Jose, C A 91125 
Vox: (408) 297 7444 • Fax (408) 297"ill • AppleLink: PACEAP 
email: infb@paceap.com * Wfeb page: hupv'/jxiceapconvjxice.himl 



PACE 


ANTI-PIRACY 

. ' "... ‘ ‘ ; 
strict copy protection obligatim 
on Adobe Systems. Beat use of th 
ue hare been usitr y PM I softe n 

protection on Adobe lypv Mutiny 

Japanese version and onruthe 

fttfu t tm i h , fh nt products far ahm > 

5 years* PACE's software saint to 

provides as with effective seem it] 
a low cost (Jin working relations 

with PACE is excellent mid 
their e:Xpert technical staff baa 
always been helpful * 

Paul Anderson 
Senior Dimior, Pacific Rim 
Adobe System*, lue. 



68K and Power Macintosh versions 

• full ANSI 77 native compiler 
•faster execution speed 
‘graphical source-level debugging 

• two complete graphics packages 

• make utility, MRWE application framework 

• System 7.5 compatible, MPW included 
■ Windows 95/NT version also available 

ab5»ift 


Visit us now at http://www.absoft.com 


2781 Bond Street Rochester Hills MI 48309 * (810) 853-0050 • Fax (810) 853-0108 - sales@iibsoft.com 




























By Jim Straus, URls9mactecb.com 


Spare your fingers and f ind I lie f ull list online at: 

http;//www .matted). tom/U R U. ht ml 

Or Kfor a limited time), send mail to: 

MacTeth-URU@class.com and you'll receive the latest list hack. 

Latest Updates 

Internet I tela ted 

Consensus http://wwwxonsensus.com/ 

fxtile Me l search http://www.ejtdte.com/ 

bn Pugh http://tw.m com/ ionpugh/softwafe/Hypertard/URU.stt.hqx 

TapSoit {l nternet User's Group) http://www.topsoft.org/ 


Other Programmer Resources 

Club Madmosh de Quebec http://www2.zone.ca/-cm q/ _ 

Everything Macintosh http://www.ts.bfande5.edu/-x1ay/rTUic.htmi 

Robert Lentz hnp://wvwv.astro nwti-edu/ientf/rnac/ 

Programmers Challenge hHp://www.rnactKh coni/Tnaii list.htmiiprog-challenge 

Vendors* Products and Miscellaneous 

Cydos Imp//www eydos com 

Entertaining Macintosh http://wwwJen.btisac.uk/students/am4001/macgames/ 
see also hup: //www. princeton.edu/-picreath/macgameV 

IY ACC http://www jyacc.com/ _ 

MacVonk http//www ccmet.abxa/macvonk/ 

MacWay mailing list mailto ltstproc@abvapple.com 

in the body of the message pur subscribe MAC WAY your name 
MaCWorld http://Vwvwmacwofld.torn/ 

Play it again Mac http://www.pht xom/macpagesMa me_nw.htm I 


IIllJGiriS 

Internet 

Architext is a small company (started by six Stanford 
students) who have some interesting text indexing software. 
Their software tries to index based on concepts as well as 
keywords. To demonstrate their wares, they've taken to 
indexing the World Wide Web and making their database 
available. Check them out and try searching for some concepts* 
Excite No (search http://www.exc ite.com/ 

Jon Pugh has created a new Ijookmaiiing HyperCard stack. 
This free program can help you keep track of your URLs, 
especially if you end up with lots of them, as I do. 

ion Pugh http://iw.cH. to mi - jonpugh/sof twa re/Hy per ca rd/Uft Ls.sit. hqx 

Macintosh 

For those of you who would like to read your Macintosh 
news in something tiestdcs English* I suggest the Club Macintosh 
de Quefxx. Tins site is a Prench-Canadian Macintosh users group, 
and they have nicely otgunized .1 lot of Macintosh information. A 
good source For those whose French b better titan their English, 
Club Macintosh de Quebec http://www2.zone.ca/-cmq/ 


Here's another huge index of Macintosh resources, Nathan 
Raymond lias put together quite an extensive list of information. 

Everything Macintosh http://www.cs.brandois.edu/-xray/mac.html 

We've all known that Rolled Lent/ has a great site for Mac 
developers, but rcceniiy I've lieen looking through some of his 
other pages. He's done an equally outstanding job with Iocs ol 
information of interest to anybody with any interest in the Mac. 
Its lime to check him out again. 

Robert Lentz http://www.a 5 tr 0 .nwu.edu/lentz/mac/ 

I've come across a couple of sites about gaining on the 
Macintosh, While we await the Pippin machine from Bandai Co. 
Ltd., you van see what's new in gaming on the Mac There's JtfJLS of 
information on Ixrth shareware/freeware and eommervial games 

Entertaining Macintosh 

http://www.fen.bris.ac.uk/stiidenH/am4001 /mac games/ 

see also http://wwvv.princeton.edu/-pjcreath/macgames/ 

Play it again Mac http://www.pht.com/macpages/name_me.html 

Guy Kawasaki has another mailing list he’s running. Tills one 
is more evangelism than Semper hi, but if you're trying lu sell to 
the Macintosh community, it would lie a good resource to track. 

Mac Way mailing list mailto; listproc@abs.appie.com 

in the body of the message put: subscribe MACWAY your name 

Finally, il you're interesting in die monthly Programmers 
Challenge, you can pin our mailing list of discussion relating to 
the challenge. Our mailing list web page ax a form in allow 
you to subscribe. 

Programmer’s Challenge 

hUp://www.maclech.com/mail-h5l,htmltf prog-challenge 

Neat non-Macintosh site of the Month 

If you didn't know, people have been pulling cameras 
around and posting the* pictures on the Internet Normally a 
camera Ls set up to take a new image periodically (every 5 
minutes, for example) and the picture pasted. Cameras have 
been set up overlooking a golf course in Hawaii, in an elementary 
school classroom, looking at a fish tank, and any number of 
people oflfces. For a fairly complete list, check chit this page. 
Cameras, Cameras, and More Cameras 
htt p: //www, intena i n, net i - cameras/ 

Well, that’s it for this month. As always, if you find 
something interesting, or have updates, send them to 

URU@MacTech.com 

Thanks this month to Christupher Allen. Bill Goodman, RoIxti 
Lenus, Jon Pugh. Nathan Raymond, and many others for their 
contributions lor their suggestions and fx miters to new and old sires 
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Hy Man Neuhurg, Managing Editor 
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Brim* Back thf: Cicon (>i j> Days 

l am an entirely self-taught, by now intermediate level Mat' 
programmer (unabashedly Pascal - CW t though I still utilize 
Think Pascal 10.2) who enjoys MacTech very much. I have 
l^een reviewing and learning a great deal from your F>ack issues 
from the “distant" past! Nevertheless, ! do have certain beefs. I 
am somewhat dLslurlxxl by the trend to Feature to such a great 
extent the more technically advanced aspects of programming 
understood hy the lew. from which the rest of us can learn very 
little, I’m afraid. In the past there was a certain gleeful joy 
about programming* a certain spirit anti amazement and 
perhaps naivete aliOUt it all that seems to lie missing now. 'Hie 
magazine seems Um» severely oriented to the well-equipped 
professional, with an insufficient amount of rime devoted to us 
weekend, sparetlnie adventurers. 

Additionally, far too much space is given over to Symantec 
and not enough to Metrowerks. And there is just too %^k m 
much C++, As a "PascalUan”, 1 read a lot of C and adapt it to 
my needs. C++ is impossible, and I find it very liaal even to 
follow the basic ideas being presented. I know that you cannot 
Force people to write articles in any one language (anil I know 
that C++ and C for that matter aren’t going to disappear), but it 
would \k- great if you encouraged authors whose articles are in 
(70+ to make some effort lo put the Pascal/OP counterpart in 
a parenthetical or a footnote. At least some effort ought to be 
made to explain the less obvious portions of the C/C++ 
program code by pointing out various things that Pascal 
programmers should be aware of and by offering possible 
Paseal/OP solutions where that is possible. After all, as was 
noted in the Novemk-r issue somewhere, MacTech is the only 
programming magazine for the Mad Efforts should be made to 
indude more of ns in the challenge that is Mac programming. 
I, for one, don't like feeling left out for no good reason, 
thanks. 

- Jeff Niederhujfer 

l/effl t sympathize strongly with your plea . At MacTech, uv re 
looking to extend ourscof*' to include once man* those "ueekend, 
sparviune adventururs ' without, of course, losing our edge as a 
forum for the professional developer community. Of course, 
sending us tin* articles is up to you, the readersf - fil manl 

{As for your comments on Symantec ns. Metrawerhs, [dense tahe note 
tin this issue) <f tlx * introduction of"From the * Factory floor our 
new column to gin* Atrtrowerks a presence in tlx* magazine You 
should expect to sett this as a regular feature and you should take 
pride in knotting that you, the readers, made it hapfxm, - hi rntj 


APPUi MlSSl Vi ITS CflASCF TO KFWRJTF THT OS 

Scon Boyd hit the nail on the head with his comments, in the 
November issue of MacTech, about overcoming limitations 
Apple has made a tragic mistake in the way it is handling 
compatibility with Copland. The legacy code of Apple 
continues to grow, with all its limitations. It is very sad that 
developers are constantly faced with constraints that could have 
been built out of the system years ago. 

Apple needs to look at the OS and see that when a machine 
has 8“J6 meg as standard. 32K worth of text tor less if it's a big 
font) is ridiculously small Apple has also recommended that we 
avoid creating too many resources (I can’t recall die exact figure, 
but 1 believe it is in the 2K range). In Apple's words, The 
Resource Manager is not a Database”. My question is: Why not? 
Why can’t we have a 10,000 entry file that contains 6GK of text 
that can lie written in a few lines of code? Why do we need to 
do linear searches to find a resource? 

llim could Apple have fixed these problems? One obvious 
way might be to create new Managers with new APIs, Pm sure 
developers would flock to suc h managers. While this would 
work, I think Apple could have done something more radical to 
rid Itself of ail this legacy code. 

Apple could have created Gershwin from the start, a real 
multi-tasking OS. For compatibility, it could create a virtual 
System 7 machine* much like MS Windows creates a virtual 
machine for DOS programs This could have l^een a single 
thread in Gershwin that emulated a System 7 environment, with 
68k emulation and all. Gershwin programs would he 100% 
native, running on a pre-emptive native OS, If you need to run 
System 7 software, you have that too, The toolbox APIs could 
be completely rewritten, no constraints required. Likewise* 
Apple could have written a new File system that fixes many of 
the limitations of Ill'S. The File System Translation Manager 
would support old "inferior" file systems, much In the same way 
as we can read anti write IXJS disks. 

Of course, we know none of this will happen. And 
unfortunately* it also means that we won 1 ! see a truly pre¬ 
emptive MacGS for at least -t to A years Boy, dial Mac will lx* 
great in the year 2000. I can’t wait. Don't get me wrong, 1 love 
my Mac. It is just disappointing that Apple has stumbled so 
much for so long. 

Mark Munz. Puppy ttog Software 
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Are your 
proj ects eating 
you alive? 



Arc ytxir projects eating you olive? When time is of the essence the quality of tlx* people and their 
work iiKiins everything... 

Swill performs above ll>e staixlan.1 level. We understand that experience, timing and costs can mean 
tlve difference for a successful project. Wlien you need a person or a team to make tilings happen, 
call as. 

We have provided solutions from the firmware level up. We work with the latest technologies such 
as Oracle Power Objects. OpenDoc/ODK & Java to bring the latest options to solving ytxir problems. 
Our technical services include Project Management R & D, Training and Technical Support. 

Swift can make the diftcrcnec. SWIFT 


To see how, call (408) 338-1414. 


O 


CONSULTING 


610 West Dr. 

Boulder Creek* CA 95006 


0 1095 Swift Consulting, Inc. 







■ 

o 

File express 

c 

Scriptable Mac-to-Mac document 


transport tools for both TCP and 

W 

AppleTalk networks. Yes, both! 

a 

If you crave the ability to send files or [1 

3 

folders from within your own Mac 


based solutions or applications, then 

0 

File express is the tool for you! 


File express Features: 

0 

• AppieTalk and TCP/IP Support 


* Built-In Compression of Files 


• Fully Asynchronous Operation 

& 

• Recordable & Scriptable Engine 

IM 

U 

• Store-and-Forward Extensions 

mm 

And all for just $20 per license! For 

(A 

more information contact us at 


Ruskin@eWorld.com, or download 


our demo from your favorite archive 

fiC 

or on-line service. Yowza! 


J 8 $>, 


ScriptWizard 


Version 1.5 


Now shipping. With all llie new features that you asked for. 

Script Wizard r * is the hesr-selling QS A/AppleScript scripr-aJiting 
and debugging tool that combines the power ol a professional 
development environment with die ease of use that yim expect of 
Macintosh® software. ScriptWizard improves ytxir productivity by 
delivering testing and debugging facilities that are as intuitive as 
they are powerful, including a Variable Watcher, true single-step 
debugging, rapid script navigai iuo* and more. 


New features,.. 

* True AppleScript statement-level single stepping, 

• Script able and Recordable* 

* Improved text editing, wlrh drug and drop. 

• "Native 11 lor bulb Power Macintosh arid 68K- 

* Quick access to Dictinnaries from .» new menu. 

• Full control over Toolbar position & visibility. 

• Re-si zable panes in windows. 

* Projector-aware bur source code control. 

* Edit and debug scripts for FaceSpan 2.0. 

• and much, much, more. 


Upgrade 

$39 

US price 
still only 

$99 



US Orders: 800 433 4989 

Tel: S10 Ml MK4. Alai sold hf A PDA & MacTech. 
Full Moon Software. Internet; salc 5 @fuHmwn.com 1 
International Orders: Tel +44 I6ZS 660242. Fax 6660B4 



Tkfirhttvfiy uf HmttUiiun: <5.S'A wt IhnwriT. 

Malvitf MtiC jMtffU .4 \vk# ftasngmifrm 7 wikit jm irkttiM&fo Applkatforis 
( fihrnnmtf Stoirft Okk - (nitfu& th’ /M/rrwjw $@ie 
Atwfinx hmimmm m<i flic* 0m Piriform HI®/ 1 
Ofttihig a Qjtmhffti JO ftiterfac? 
fbe tksfot (j/ tuh'rtictnr Mrimn Actuations 
lb? Macintosh as an hikrnd Smw 


If you have a way-cool application, 
a Hew technology or new way of doing something, 
or a good tutorial on present technologies anti lion lhc\ work, 
we want a paper fmm you* 


Abstracts m required In tebwajy IS, 1996. PI em submit them la 
jcrii@aol.coA) wiiii a subject field of 'Mad tack Abstract' 
florrcsjiandenoe encouraged 


Mm Ii widh ut*l Mlm Bn i»KMnd uriii.iil* 1/ ^4 ftwfUto K i^lmTnik'i.iifa, nic|w^, 'ri dmc iiw imfcfcn kL.it, 4 m mt 
111 jf, . 1 f Hull I flu hi, JJIIhJlfij mh Mr MUdidi ■“ 1 oni^ All Nalfuil 


mxmwvM 

% 

UKtvuremf 

It’s not just the basics anymore ! 

Advanced courses from Developer University 
get you up to speed quickly on new Apple technologies^ 

U OpenDoc 

□ PowerPC 

□ Newton 

□ fx rapine sffmaging 
J Apple Guide 


Courses Available as 



Self-Faced Classroom Lecture Online 


For more detailed information, check out our World Wide Web pages, 
hop:.-www info.apple.com. or contact die Apple Developer University Registrar 
at (40K) 974-4S9 " t or fax (408) <P4-0?44 

Dcvdopcr fnb’crstty, Apple Computer, Inc J Infinite Loop, MS 30 MTLL Cupertino, CA 95014 
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Dilbert hy Scott Adams 


I'D FIX IT mSELF BUT t 
KNOW IT TAKES SPECIAL 
T00L5. .. 



PLUS I WOULD TU5T 
HAVE TO ORDER A 
PART... AND m 
PRETTY BUSY. .. 



ENGINEER’S 

PILLS'? ™Y’LL 

KNOCK YOU 



From idea to delivery'.. 



Complete 

Software 

Duplication 

Service 

800 - 222-6032 


o 


SuAwarr Dupltr .ilimi • 11) KOM 
# Awvmhly 

1'rinlmt; ♦ idlin' ♦ Mii|i|iim^ 


“/ FAST ^ 

© o 


:ill handled with rop 

Q1/AU r n \.. SHR VICE ... SMihD 


For 11 Years! 


Itncmauirnil fhlittairw I tic 
2278 Trair Zone Blvd 
San Jok -CA 951J1 
(408)262-6660 
Fan: (408)262 8906 
ititrritc U illilu!*^ jtiJ.tiMii 




Can you spot 
the difference? 


Plenty uf people an i Because wklher you ujxIjlc software will* ;i 
full set of program disks, 4 file made with UptlaieMaker 2. the rvsuli 
is the same Guaranteed l pdaieMakef ufxkum aw iiNaJly reliable 
tls system of 52-1 in cliecksuins ensures that it updates the right file. 


And UpditeMaker is easy-to-use - simply specify the files and 
UpditeMaker hgilds the update Utere is no scrijitmg or use of 
Rc.sKdil It s even easier for end-users - just one hurt on to press. 


I fpdalcMakcr 2 works wfth any type of Macintosh file. Hie updater 
tiles art oBaittely compact And ik pnjfirim opt nuns mime roils 
Vr>u can preserve or overrule uht rustonusatums \i\r Piles m knlivx 
format Update up to 20 old versions wifi onr fife. 


Hr: real difference is the savings in time and money Which 
e Apia ms why xhuc of the fieM-known names in software 
development have already discovered I'jKLiteMaker 2 

Uisirihiitiim Is unrestricted and royalty-free. 

Only $225, order now, fax (415) 964 2886 

ApptrllflkMjctjbW- lmrrwlJ4»Ub(W'#Ap P lrUr.k.\pplr J ,.in 


w 


UpdateMaker 2 


ADinsinimtiits. 2225 Gram Hoad Sulk *i, LoS Altos. Ga 94024 Phone: HI5) 96-i 28*8 
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Programmer 

Training 

MACINTOSH SF M IN A *S A CON51IIHNCV ^ 


64 


Richey S< »ft ware 'I raintng pre tv ides 
proFcssi*ami CMa/owtocY/ programming 
seminars and industry consulting. 


Kieh content & hands-on lab 
exercises shorten your learning curve. 
On-site training is convenient — your 
teani cl i mlna ivs ex pensive imvd «isi s 
and consuming down-time 


/Vu/e&rfoffd/ & consultancy 

tlutt malty hits the mark 




Ci 11 today to-find out how K ichey 
Soft ware Training delivers professional 
seminars and consulting nationwide. 


MAC 

SEMINARS 


•CACh 

*0Df 

- MacApp 

• hltt'LTlX 

- AppIvSt ri{>! 

■ MPW 
*Sys»rm” 

* IS luiji^inji 

■ V iiin « Hir^ 


RICH tV 



Mjic I'rugr.! riijiu-r* >*ocir 

707 * 869*2836 


Afttk-Unk Kintf V«T|T 

I\ T1 ! N sn TWO JTlWii»BttptMrr *v *«tw 
rti urn m*> r.iriiMViiu I v-a+h-iki^ 


M Developer Tools to Support 
Adobe Adobe*"* Technologies 

Adolxj provides a complete set of tools and 
services tor your development needs. Whether you 
wont to integrate Adobe Acrobat™ capabilities into 
you* applications, add PostScript™ language 
supporl to your products or create powerful 
Graphics Application Plug-ins, Adobe has the toots. 

These Software Development Kits now available 

^ Adobe Acrobat™ Plug-ins 

^ Adobe PostScript™ Language 

^ Adobe Photoshop™ 

^ Adobe Illustrator™ 

^ Adobe Premiere- 

^ Adobe PageMaker™ Additions 

^ Adobe Fetch™ Content Publishers 

To have information faxed to you, call (206) 628 5/3/ 
and request documents 1220 and 1233 


Adobe Developers Association 

1585 Charleston Road, Mt. View, CA 94039 


Late Night 

iOMw**{ 


Script Debugger 


Snipi Debugger is j powerful irui flexible AppleScript 1 * arftorJag mol lhal makes 
M easy for novice and experienced scrip* writers 10 get the most from AppleScript 



program [Script Debugged 
is a solid performer, and its support 
for large file sizes, helpful 


Script Debugger 

■ Offers true ssigle^ep euarnw of 
oft AppleSatpl scripts 

m Frondes 0 powerful Kiiplmg enwaflr 
menl thot ncludes Drag & Drop editing 

■ Is Power K Native 

■ Is saiplable and ntrochcWe 


Oktimry window, superb scripting 
additions and complete scriptobiiity 
moke it a my good choke . - 

An Rappoport end £d Alien 
A Magojinc 


idle Highl Software Lid 

$100 Voite f«H)tW-S57( 

? 1^7 fax («4) 9294961 
E-mail 


becoming a Macintosh Service hrtwider continued from fjage 59 


of one to two hundred per month* About 900 listings are 
currently searchable. Some oilier Internet experiments and 
surveys indicate I hat as many as 5000 Mac OS WWW servers 
may be publicly available on the Internet. If automated 
techniques being developed here for listing them work, the 
number of servers in the listings will grow dramatically before 
New Year's Day 19%. 

The STAR Site 

In an attempt to help focus attention on some of the Hurst 
sites, a STAR site was established to feature a Mac OS site every 
few clays, and this is the second mosi popular page at the site. 
The New Servers listings page is the most popular so far. 

List your Mac WWW sites, public and internal! 

If you're considering establishing a Mac OS WWW site T take 
some time with these listings If you have at least one Mac OS 
WWW server, list if We ask that th<»e who have internal WWW 
servers, bui who si ill wish to participate in (he Mac WWW Server 
community, list their URL as “internal site," so tliat NetScape will 
report “cannot connect to server... internal site..." In this way all 
Mac webmasters who wish to can show what they are doing with 
the technology, and meet and work with others who arc 
attempting similar efforts, whether public or private. 

it 
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Tips & Tulhils continued from page i 12 


InitGntn fctjd.thrPon ); 
lnittfumst ) t 

InitUindavfiO \ 

InitH«nui(J; 

TElaitO; 

tnltDiitoRsf 01 h 
Iftit-Ctiritor (1; 

HaxA$>pl£eme»0 ! 

I // t*ml JmtThcMot 

static Boolean CetAFlUC FSSpecPtr file ) 

\ 

SFTypeLisi types; 

St.anrUrrfFi leRaply reply; 

StontfnrdUcUFilet NUU.* J, typnfi, b reply ); 
if ( raply, m fGooJ ) 

BlorkKovtf( Areply, ufFills file, fliaieof < FSSpcc ) 1; 
return rt?ply. . sfGood; 

1 // end GciAFUt 

void tnalnf void ) 
i 

FSSpec urcF Helper: 

OSICri tlieKrr ” itoKrr; 

InltTheJUc(); 

if < CetAFHef &*rcFlI«Spec } ) 

theErr ** fSpTraahFliof &j>rcFi leSpet ); 

1 //end main 

lend if //TOT. TRASH Fill 



is a collection of five menu defini¬ 
tion resources (MDEFs) that you just 
paste into your project *s resource ft fa 

Build a menu using the MDEF and 
then just handle menu selections like any 
normal menu * 


ID ft!nK ► ' 

f tllDfl ► 

DMlMhAlf 
(bit V rrtt 


Also contains MaUre d\ a special menu develomenl tool 
that assists you in designing yaw MENU MILL Menus. 



■ Use your drawing programs as programming tools 
* Fast unobtrusive RGB color picker 

' Space saving Geneva 9 MDEF 

■ Calander Menu 


JUST^i 


$ 69.95 


Write, Arid Publishing. Inc* 
11A Leisure Time Drive, 
DianumilM. MS 39525 
Call (601) 255-6713 
FAX <601)255-7086 


mtVTikOP&D IIY STAZ SOfnVAKL, INC 


Visil MacTech Magazine’s Web siic! 

http://www.mactech.com 


To receive information 
on any products 
advertised in this issue, 
send your request 
via Internet: 

productinfo@xplain.com 



Bug Tracking the Macintosh Way 


TcstTrack automates .uui simplifies tracking pur bugs so pu 
ran coucniLmu-on toting than. Easy to set up, easy louse, 
and quick too! 

it Track bugs, change requests, testers, 
configurations, and more 

4 Produce coneise reports 
4 Automatically route bugs to tram members 
4 Minimum setup time 
4 Multiple users. full security 


IAr* inote irdomutmn, mil w dmd c-tmiJ in «*iprr»" s tL-tjnrJwl 



Wpilw VrftTiTT, Inc, 

Oourt 

WUwWl-€H«EW 
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MacRegistry M O 

Developer Job Opportuni ties 

If you arc a Macintosh developer, you should register with 
us! We have a database that enables us to let you know about 
job opportunities* When we are asked to do a search by a 
client company the database is the first place we go. There 
is no charge for registering. The database service is free. 
Geographic Coverage is nationwide* 

Marketability Assessment - To get a specific fed for your 
marketability send a resume via Email or call. You may also 
request a Resume Workbook & Career Planner. 

Discreet Wc are very careful to protect the confidential iiy 
of a currently employed developer. 



StKATTNER NETWORK 


COt^’VFLO CONSULTING StrtVICES 

T b0 Trattner Network (TTN) IS look mg for experienced 

Macintosh devukjpefs tor cutting edge opportunities in Northern 
California and across the country 

T TN represents clients whose pmjecls lor consulting and Full 
Time Employment inebdo development in Open Doc* 
Cyberdog, Copland, Newton, PowerPC, Metrowerts, 
MacApp. and many others 

OW*— hie Trattner Network has urgent needs for: 

* Software Developers * Hardware/Firmware Engineers 

* QA/QC Professionals * Project Coordinator/Managers 

* Multimedia Developer* * Network Professionals 


Scientific Placement is managed by graduate engineers, we 
enjoy a reputation for competent & professional job place¬ 
ment serv ices and we are Mac fanatics. 


v 


1-800-231-5920 • das® spi.com • Fax 1-800-757-9003 

h 11 p;// w w w„wicn ti ft c, com 


Scientific Placement, Inc. 


Mr , noi rx nm n t-** imm+am 

Ml. Hm 71, Sin Hjiiuni, VA'Mm 510-733-6168 bcSMNpic.Ml 

MT, 202*76, Auulp rx 78750-2*7* 313-2600123 act 

MT, ki hiiHHi Si mkhi, Rot 1372 V MA02215 617-424-X372 jrttd*rtjtpj* pfi -jwti 

-Vpi'U U tiA 0J3KU. Cum(werw 71230.^101, rWurlil m ACM, d*vraih«U 


J 


The Trattner Network has a unique history in Mac consulting 

coupled with exposure to emerging technologies If you are looking 
lor a chance to enhance your stalls and marketability, 

please send, fax, or link your resume to; 

The Trattner Network 

Arm FmifyHootwu 

170 Stale Street. Suite 240 • Los Altos, CA 94022 
Phone 415*949*9655 exi 115 ; Fax; 415*949.1025 
Applet ink traf net, F-mail emiiyflirflmei.com 


THE DIGITAL TALENT SOURCE 


MACINTOSH SERVICES 


Publish Your 
Software Free 

United Software Exchange 
will market your software 
nationally at no cost to you. 

Interested? For no obligation 
tnforrmtpon email Ralph at 

USoftEx@aol.com or 
call (708) 5 82-7465 


-Hh 

USE 

UNfTW Software frxc hangf 


"Object Oriented Code? 
Sure, between rides!" 



Macintosh ft 
Programmers & 
Adventurers *4 
Wanted 


- MiilfifH 

ft*frj*ii 

0 * hti w*)r 
tt w*rt 


MacXparti ii 

* software 
development 
romptny 
with in* 

Me openings 
for M»dnto*lt 


Miic programming experience. 
Take the first $tep to adventure. 
Call Miduef Ruttle au 

1 *00-156ar ( 41 /BM j}8 314? 

leirreeT: ip* 

tapirU«b; ipvm iOt: Hedp*m 

Sttp i. eia^fti.Ha' - ip«rti 


MindVLsioa Software 

(cxi author* of Sjiccd fkwhtei) 

wants to pay you well, 

insure you and your family, 
give you lots of vacation lime, 
great equipment to work on, 
great people to work with, 
listen to your ideas, 
and help get your name in the 
credits of some of the 
most successful products in 
Mac A PC history, 
ttv ask only that you try as hard 
for us as we will try for you! 

If you want to team up with a 
great software company contact 
(ou Id lie Me i l im 1 rod visit m cam 
Various positions available 


MacTech Magazine 
is your 

recruitment vehicle 

When you need to fill 
important positions at your 
company. Mai Tech Magazine 
is the consistent choice of 
companies across live country 
for hiring the best qualified 
Macintosh programmers and 
developers. Let MacTcch 
Magazine deliver your recruit- 
ment message to an audience 
of over 37,000 qualified 
computer professionals. 

Call Ruth Subrin at 

805 /mw 
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OJ INTHRACTI Vi ! . 
K'NTERTATnSiKN t 


Westwood Studios has 
openings for talented 
Macintosh Programmers 
to work in-house. If you 
have 3 years experience 
coding C/C++ on the 
Macintosh t we’d like to 
hear from you* 

We are currently 
celebrating our 10th year 
of leading-edge games 
development* Our most 
recent hits include 


Command & Conquer, 
Monopoly, The Lion 
King, Dune II, and The 
Legend of Kyrandia, 

We offer competitive 
salary and bonuses, an 
excellent benefits package 
and a challenging work 
environment. A move to 
Las Vegas means no 
state income tax, 
affordable housing and 
outstanding scenery* 


MAC PROGRAMMERS 


For confidential consideration 
please send your resume Attn: Elsbeth 
Westwood Studios 
53.13 S. Arville, Suite 104 
Las Vegas, Nevada 891 IS 
fax (702) 368-0677 * phone (702) 368-4850 
entail careers@westwood.com 
website http://www.westwood.com 


Got Software for Sale?™ 
No Advertising Budget? 


Try listing your product in MacTech Magazine’s Mail Order Store 



Classified Advertising at %post effective rate! 


For more information, call, fax or e-mail: 
Voice: 805/494-9797 • Fax: 805/494-9798 
InierncM: marketing@xpluin.com 
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By John Kawakami MacTecb Magazine Editorial Assistant 


Yet Another Plaitokm for CodfWarrior: Java 

Metrowerks, the leading provider of Macintosh development 
tools, today announced that it will provide a suite of Java™ 
development tools, code-named Wired, fur the Macintosh 
platform In addition, Metro werks announced ii intends to ship 
the first developer release of the Java too! suite in May, 1996. 

The combination of Java, CodeWarrior and the Apple 
Macintosh makes for a powerful Internet development .solution. 
Sun's Java allows Internet sites to fully incorporate motion and 
sound, real-time information updates, and user customization 
and feedback. Apple's Macintosh family of personal computers 
is heralded as the multimedia development platform of choice, 
with Dataquest estimating 63% of multimedia content is 
developed on the Macintosh. Metrowerks* Code Warrior pnxiuct 
line is the market-leading development environment for 
Macintosh, and is widely credited as a key factor in enabling 
hundreds of Macintosh developers to make a quick and easy 
transition to the RISC-based Power Macintosh line. 

Using Java, which is syntactically similar to C++* developers 
can write custom mini-applications called applets. When 
integrated into Internet web pages, applets can enable expert 
graphics rendering and real-time interaction with users, live 
information updating, and instant Interaction with servers on the 
Internet. Applets are downloadable from any server and run 
safely on any platform. 

Metrowerks will provide full Java support in its Macintosh 
hosted CodeWarrior products. The company anticipates that 
the first developer release of Java for the Macintosh will lx.* 
ready for Code Warrior 0. which is expected to Ik: available at 
Apple's Worldwide Developer Conference in Man Jose, 
California in May 1996. 

Metrowerks: 

mailto://info@metrovwrks.com 

http://www.metrowerks.com 

Sun; 

http://java.sun.com 


Apple's Now Has Creator Code Registration 
on the World Wn>i Web 

It you haven't been registering your type and creator codes with 
Apple because their HyperCard based registration system is out 
of date and tnconvendni, well, you now' have no more excuses* 
Apple has put type and creator registration forms on the web, 
and registration is faster and more convenient than ever. Fill 


out the form and submit it to Apple, and you receive a 
confirmation or denial of your request around 48 hours later. 

Also at this website, Apple has also implemented a 
searchable database so potential registrants may verify that their 
choice is unique Developers can search up to sixteen codes at a 
time to see if they have been assigned. Owner information 
related to the codes, such as company, contact, address, phone, 
etc. t is confidential* Also available on their web is general 
information about registration and other creator code related 
information, 

A form to register your file type and creator codes: 

http^/devinfo.apple.com/cftype/m3in.htmi 

A form to search the database: 

http://devjnfo.apple,com/cftype/fmd.html 


Apple Delivers OpenDoc for Mac OS, on Schedule 

Delivering on its promise to complete the development of 
OpenDoc component software technology in 1995. Apple 
Computer Inc, today announced the availability of the 
OpenDoc for Mac OS Software Development Kit (SDK), which 
contains the completed OpenDoc software as well as sample 
axle and tools for development of OpenDoe-based solutions. 
Demonstrating their support, 300 software developers who have 
been working with early versions of the SDK. made 
commitments to deliver OpenDoc-based components to their 
customers in 1996. These commitments mark the beginning of 
the evolution toward component-based software aimed at 
making computing easier for all users. 

ily shipping OpenDoc, we ve taken he first big step toward 
the next generation of |x.Tsonal computer software*” said David 
Nagel Apple's senior vice president of worldwide research and 
development, "As Apple and others make OpenDoc-based 
solutions available in 1996, computers will become more easily 
customized For the needs of specific users, and well see small 
innovative software developers returning to the software 
business. And becaase OpenDoc is created by an open alliance, 
computer customers w ill get more freedom of choice and won t 
lx- tied to the arbitrary decisions of a single company.* 

Apple plans to deliver the OpenDoc technology to its 
customers as pan of the Mac OS, through hardware bundling 
and in component-based products throughout 1996, Apple 
also is actively incorporating OpenDoc technology into its 
system software. 

The OpenDtx fur Mac OS SDK Includes OpenDoc system 
software for Power Macintosh anti 68Ox0-based systems, sample 
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code, full dtJcutncniaiKJn, and a set of development tods. Apple 
also plans to deliver versions of OpenDoe in 16 additional 
languages in early 1996. Developers tan download the entire 
SDK I beginning on November Id, 1995 through die World Wide 
Web at http://www.Opendoc.apple.com or send email to 
opendoc@apple.com to receive a free developer CD by mail. 
flhere uiU fm a cvpy <f tin* OpenDoe LO CD in the February issue 
of Mac Tech - watch for it! Pub. nstj Developers can also 
download additional development tools from Apple, Mettowerks 
and Symantec, including a pre-release version of Apple s 
OpenDoe Devdopmeni Framework (ODF) for Mae OS. 

Component Validaion Services 

Cl Labs, Lhe vendor-neutral industry association for 
distributed component technologies, last week announced its 
plans to roll out component validation services in the first half 
of 1996* These services along with an accompanying logo 
program will deliver on the promise of interoperability that Cl 
labs has pledged to provide. 

The Promise of Cross-Platform Component Software 

Hie availability of the OpenDoe for Mac OS marks the first 
of four platform implementations planned to ship over the next 
year. In addition to Apples plan to deliver OpenDoe for the 
Mac OS, IBM Corporation has announced plans to deliver 
OpenDoe for AIX. OS/2, Windows NT and Windows '95. 

OpenDoe Support Grows 

More than 300 developers have slated their support for 
OpenDoe for Mac OS and their Intention to deliver products to 
the market in 1996. This list grows daily as an increasing 
number of ISVs see the opportunities to use component 
software to deliver innovative products to their customers. 

Interspersed among the 300 well known and unknown 
companies planning to support OpenDoe are a handful of 
unlikely OpenDoe developers including the following: Kinko's 
is a US based chain of photocopy shops; Pac Bell Directory 
publishes yellow pages phone hooks; Viacom is the media 
giant that owns the cable network. MTV; anti Virtual Work! 
Entertainment runs a chain of 'virtual reality" entertainment 
centers where you go into a fake “cockpit", complete with 
switches and lights and a big computer monitor, and wage a 
simulated iiobotech/BariSemech war on your friends. 
OpenDoeVR? 

The complete list of committed companies is at: 

http://www.opendcK.apple.com/committed.htnil 

The very attractive OpenDoe homepage, where you may 
download OpenDoe and the ODF, is at: 
http://www.opendoc.apple.com 


ICQN1X Dm its Ofijicr Oriented Methodology 
Training on CD-ROM 

Longtime object oriented programming tools developer and 


training consultants, ICONIX. noted thai programmers were 
requiring more education and training about GO 
methodologies. As president, Doug Rosenberg, commented, 
"1CONIX has been fighting CASE tool feature wars for the last 
eleven years. A few' years ago we realized thai adding more 
features to our CASE tools wasn't increasing the success rate of 
our clients on their projects, and dial we needed to deliver 
methodology training directly to the desktop. 

"Gur first CD-ROM training course "An Object Methodoloy 
Overview* provides a good start in that it helps to understand 
the big picture of OO methods in an incredibly short time, but 
our customers have been very clear in expressing their need for 
"on-line methodology help with the same level of detailed 
instruction we provide in our on-site training/ 

Anticipating the trend that has brought Booch, Rumbaugli T 
and Jacobson together in an effort to unify their methods, the 
CD-ROM titled M A Unified Object Modeling Approach" offers 
extensive tutorials on the strengths of each method: Jacobson 
for user-driven requirements and traceability across the 
lifecycle, Rumba ugh for domain analysis and reuse across 
multiple projects, and Booch for detailed C++ design. In 
addition, prototyping is stressed as a requirements definition 
technique, with extensive explanations on how to derive Use 
Case anti Domain Object Models from prototypes. 

ICON1X Software Engineering, Inc (ph. (310) 458-0092): 
http://www.biap.com/iconix/ 

Mac Rack Winner, CybemFindek, Goes Gommfrcjai 

Aladdin Systems began shipping CyberFinder 2.0, a utility 
which gives Macintosh users an easier way to navigate the 
Internet* Based on a entry to the hack contest at Mac Hack, 
CyberFinder is a control panel which allows users to create 
new types of Finder icons, called ^bookmarks/ that point to 
sites on the Internet. Double click on a bookmark, and the 
proper application launches and resolves the URL 

CyberFinder 2.U sports a nifty notable feature, N HntKevs\ 
which will allow users to go to Internet sites from within any 
application they liappen to l>e using. The user simply selects 
the URL. presses the IIotKey, and voila, instant gratification. 
Now- yon don't have to wait for your favorite email client to 
add Internet Con fig support f There's also another handy 
Hotkey which will M grab H a selected URL and produce a 
IxKikmark in a designated folder 

If yem need CyberFinder. you already know it. Die price 
is US$30. There's the original version at the MacHack site 
below, and a fifteen day demo at the following: 
http://www.aladdirtsys.com 
(tp://ftp.a!addrnsys.com 

lhe original Mad lack entry was also called CyberFinder 
and is available at: 

ftp ^/f tp. machack. com/H a cks9S/Cyberfi n der.si t * bin 

* 
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Leam € on The Macintosh /v. 
Second Edition By Daw* l£t& 
Walk Learn C on The Macintosh Second 
Ettifion This is a nuruptetety revised 
edition £>t Learn 0 on Hve Macintosh With 
this sell-leaching, easy-to-understand 
bouk and I he enclosed CD Rom , you ml 
everything you need to slant programming 
to this widely used language Npw to tins 
edition are updated and enhanced 
exercises that lead you step by step 
through the programming fundamentals 
and C language basics including lunclion, 
variables, pointers datatypes data 
structures, and lhe file inpul and output 
Also new is completely rewritten code, 
plus aaswers and source code for all of the 
exercises Ttie new CD-ROM with 
Melruwerte Code Warnor 1 * Die, a special 
version ol one of the hottest Macintosh 
programming erwironmcnts, (including a 
PowerPC version) $344& $31,45 

Tricks of The Mac Game/j^ 
Programming Gurus s i W 

uRcmaAft resource for beginning tn expert 
game programmers who already have 
general programming expervsme Complete 
overview of all me necessary eurifporwis ol 
game programming on the Macintosh 
Hundreds ol tips, Incte, and insider scads 
trom Mac one programming experts on a 
CD-ROM. packed with valuable loots, 
utilities sample code. Code Warrior 1 * Lite 
and game demos Coverage ot u/ttiny-edge 
topics such as QuickDraw 3D and Power 
Mac optimization and Inside info on how 
Glyplta ill was created Unique in the 


marketplace - no other Mac game 
programming book is this complete 1 The 
book contains Instruction, Kps, and source 
code ham the top names in Mac game 
development today The secrets, examples, 
and code can't be found anywhere eTsef 
These are lire trieiteantHrue btefcs that work 
behind the scenes in the most popular 
commercial and shareware Mac games 
Throughout the book, you'll find special 
interviews with some tit the must well-known 
Mar, game programmers They reveal their 
secffll solutions created wh ile iney developed 
thfllf papular games,fM $ 45.00 

OOFILE is the lirst OODBMS /p*. 
Iramework ro otter a comp tele ijjESft 
solution tor application authors 
Replaceable backend database, currently 
Faircom's c-tree Plus lor cross-platform 
royalty-free power PowerPtant and other 
frameworks integrated with edit fields, 
database browsers & more. AppMaker 
users, generate complete applications 
User-friendly syntax makes it easier to 
migrate irom FoxPro and the non-00 
wot Id Demo’s on CodeWarrior and 
AppMaker CD's $900 for a once off c- 
liee bundle, or $1,095 Hear 
subscription HTML and character-mode 
report writer $195 Full GUI report-writer, 
including HTML, is $495 Mac Platform 
Bundle - includes all Mac frameworks, c 
free, and Report-Writer £1,495 

PowerTap “ accelerates sull- 
ware by lapping Into mulliple^gfcfr 
processors Version 3 0 taps into 


networked Macs and ail processors found 
in the new mufti-processor Macs 
Developers can speed up their 
applications without having to leam about 
networking, communications and task 
scheduling algorithms I he PowerTap 1 * 
library has ttie easiest API - it behaves as 
a simple black box where tasks arc 
submitted and results retrieved Full error 
recovery is built in* so youf job will 
complete no matter what Power lap's 
advanced scheduling algorithms ensure 
oprlmal assignments and the fastest 
exermlion possible. It is compatible with 
all Macintosh hardware, soltwarc and 
major compilers. Version t comes with 2 
remotes - $1200 Version 2 comes with 5 
remotes $190(1 Version 3 comes with 
unlimited remotes - S27CXJ 

Roaster DR1 Be the lirst/ jk. 
Macintosh developer on ynurlj^ 
block to take advantage ol the unique 
capabilities of Sun’s 1 * new Java 1 * 
Programming Language' Developer 
Release i ol Roaster™. new Irom Natural 
Intelligence, Inc., is the first ever 
development environment for writing, 
testing, and running java™ applets on the 
Macintosh Features Include: fully 
integrated development environment - 
project window that includes a Findef-like 
view of packages - lightning-fast - 
Macintosh native compiler - source code 
editor with powerful search features and 
intuitive use interface runtime engine 
for quick and easy apple! testing When 
you purchase Roaster™* you aie emitted 


to unlimited, personaiiTBd tech support 
throughout the length of your 
subscription DR 1, DR 2* Roaster t 0, and 
one additional update Roaster 1 * is 
accelerated for Power Macintosh. 
Requirements Macintosh or Macintosh 
compatible computer with a Motorola 
60020 nr higher or Power PC processor 
CFM-68K (for G6K machines): 8MB RAM, 
Color QuickDraw, System 7. 1 2 or later, 
(System 7 5 or iater for 68K machines), 
CD-ROM drive to install the software 
price: £399 Special Price $299 

Symantec C++ is lire Industry-standard 
Macintosh devekipmeni syslcm-and now 
il's native tor Power Mac You can develop 
full-featured Power Macintosh applications 
quickly amt easily using mvulufiorwy new 
features mat save itrne and enhance your 
productivity Ihnxigtioul the development 
cycle Lmmoronent includes A true native 
Power Mac implementation of the C++ 
language including support tor Templates 
and multiple inheritance, MiC/MiCm 
compilers for last Power Mac executable 
code (22% taster Ilian with the standard 
Symantec or Mt&owejfcs compilers), Visual 
Aidiiled lor last easy GUI generation: A 
new THINK project management system 
that supports large, complex applications, 
nested projects, and htetarclucal project 
organization, A new edi I or/browse? that 
displays classes and automates many 
editing lundions, A powerful, easylo-use 
source code debugger, The industry- 
standard THINK Class Library, Free 
subscription receive the next two updates 


|jj MACTECH MAGAZINE PRODUCTS & ORDER INFORMATION 


K-mul), Fax, wrile, tir OUl us Y*>u may um.' 
your VISA, MasterCard or American Express; 
or you may m ml chuck nr money orcter (to 
l TS funds only): MflcTrdi Magazine, P,U. 

*' Westlake Vtoagt. CA 91359^5200 
Vijkt* 805/404-9797* Fax-80V494-9798 

tf v *hi arc an e-mail you can pbcc 
order* or Contact customer sender at 

* AppleLink MTCIKTSVC 

* UiMipu5civc 71355*1063 
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US Maga/inr $47 for 12 ivaus 
Canadian; $19 for 12 issues 
Ink+iuisoiul; $97 fur 12 tomes 


US Magazine with Source laxle Disk; 

$124 for 12 tomes 

Canadian Magazine w/Sourcc (ante Disk: 

$136 for 12 issues 

International Magazine W; Sourer Code Disk: 

$194 for 12 issue* 

CMOM 

MarTech CD-ROM, Volumes 1-10: Includes 
over 1230 ankles fmm alt 115 issue's 
( 1984-19941 of MacTech Majpite (formerly 
MacTutorL All arilde text and source rode 
Maw tn THINK Refe rence fbnnat The CO includes 
Symantec's THINK™ Kdmuv 2,0, working 
applications with full documentation* product demon 
for develnpeis amt more. $«? .ulveftisemeHl, it us 
issue; 549 Upgrades $39 
K-rnatl. coll or write for into 

ROOKS 

The Best cf AiacTutar, Vol l: Sold Out 
The Cowptete MacTUtor, Vol Z- Sold Out 
/be Essentia! Mac Tutor, Vot 3, $ 19 91 
the tk’finrtue Machttor. Vd \ $24,95 
TbcBestqfMttc fuiQK Vol. 1: $34.91 


/test t/MtalUiur Qjttexxion, Vdunes 3 - 5 sw 
litrii tyj Skh TuUtr, Votumes 6, 7, 8 <X 9 

Hoc available 

DISKS 

Sourer Code Disks each 
Topical Index i 1991 1 un disk $1 

M\fiA/JNh HACK ISSUES 

Volumes 3. 4. % 6* 7, 8, V anti 10: 

$1 each Isutijeel to availahility) 

Calif umta tesrdeot% toe I tide 8-21% >ate^ tax 
tin all v»ftwate. disks and Njok> 

Alk>w up lo 2 weeks for standard damexUc 
cmltTS, nmre ujik j for internalkm*il oftletv 

pi ias* wriT 

Source t cxle disks and fournals tom MacTireh 
Magazine arc licensed m ilte purchaser for private 
use only and arc nor to lx: copied Un c u a u n e i t iat 
gain I km ever, due- code contained thereto may tie 
included, if property ac know ledged, tn aimmercftil 
fxoduas a 1 no additional charge All prices arc 
vibk*t to change wUlioui notice. 
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tree when you send in your registration card 
and morel Pries: $399 

Symantec C++ for 68k, allows you 
to build applications fester and easier with 
the pnwerlul combination nf fully 
integrated visual tools and the latest in C 
and C++ compiler technology, C++, now 
the standard in development languages, 
provides an object-oriented approach to 
application development, and the resulting 
code is extensible, reliable, and 
maintainable. Includes: Integrated 
Environment with lull source-code 
debugging, integrated editing and 
browsing, and resource creation and 
editing; support tor standard language 
features such as templates and multiple 
inheritance as well as quick compile limes 
and highly optimized code; Incremental 
Linker which eliminates long link times; 
THINK Class Library - a mature, C*i 
based, application framework provides a 
solid foundation on which to build 
factored and scriplable applications with 
support for 0 m exceptions, run-lime type 
identification, persistent objects, and 
AppteLvents; Visual Architect™ to visually 
design your user interlace and 
automatically generate complete THINK 
Class Library source code; THINK 
Inspector which provides you with quick 
and easy navigation of your application’s 
class hierarchy while it is running. Project 
Models to star! new projects quickly from 
templates either provided in ibis package 
or created io lit your own needs; Source- 
Code Control with integration with Apple's 
SourceScrver (included) provides reliable 
version control and supports team 
programming. Support lor Scripting lets 
you automate complex, mulliprojecL 
operations using AppleScript or Front ter 
scripting; Powerful Standard Libraries 
which includes 10 Streams, ANSI standard 
C library, and sample programs Full 
source code is included; Extensibility 
supports third-party editors, and 
AppleScript and MPW tools {available 
from Apple) and aliows access to THINK 
Reference; Create applications: desk 
accessories, device drivers; and any kind 
of code resource, including HyperCard 
XCMDs and XFCNs. system extensions, 
and control panels; Migration Path to 
Power Mac Create applications that run 
on 68K Macs and Power Macs (emulated) 
These applications can easily be migrated 
to native Power Mac. by trading up to 
Symantec C++ for Power Mac. Price: $79 

Mastering the THINK 
Class Library by Richard 
Parker. Now that Symantec's tong-awaited 
PowerPC native compiler is here, developers 
are taking another look at THINK. This book 
provides a thorough examination of 
Symantec's extensive Class Library and the 
Visual Architect, a graphic user interface 
development tool that allows you lo produce 
commercial-quality applications with a 
minimum of effort. A complete description of 
the structure and operation of the TCI 
includes explanations ot all code generated 


by the Visual Architect, any necessary 
custom code, and the operation ol this code. 
Visual Architect tutorials provide you will! a 
step-by-step approach for simp 13 tying the 
development ol complex Macintosh 
applications 496 pages fl i jfl.flfi $25.96 

A Fragment of Tour/^, 
Imagination by Joe Zobkiw W# 
Here’s some practical help for creating 
code resources and code fragments for 
the Macintosh and Power Macintosh 
Rather than simply gathering and 
indexing chunks ul this vital code, the 
author provides thorough explanaiions to 
teach you more about how the Macintosh 
system functions as a whole. He also 
provides hard to line! informal!on about 
techniques used to structure and build tat, 
sate tei, and accelerated code resources 
for use on both 680x0 and Power 
Macintosh. All code is reusable and is 
provided on the disc, along wi!h 
Metro works ['ode Warrior Lite, Bnok/OD- 
ROM, 528pages m $35.96 

inside CodeWarrior 8: 

Includes CodcWarrior IDE User's 
Guide. This manual shows you how lo use 
the CudeWardur IDE {Integrated 
Development Environment). 
It shows you how to create 
software for 68K and 
PowerPC Mac OS, 
Win3?/xfl6, and Magic Cap 
ft also shows you how to 
use TuofServer from the IDE arid how to 
control the IDE using AppleScript. The 
next highlight is CW Error Messages, 
which describes the errors you might 
encounter while using CodeWarrior 
compilers and linkers. This manual 
contains descriptions, source code 
examples, and lixes to these errors, as 
well as the Debugger Manual, which was 
updated for CW7 including new inline and 
exceptions debugging, and a new 
troubleshooting section. Next up is hie 
MPW Tools Manual, which shows you 
how to use Metrowcrks compilers, linkers, 
and other tools under the MPW Shell 
Updated lor CW7, new chapters 
comparing MetruwKFks and other MPW 
tools, and then onto C, C++, and 
Assembly, and Pascal Language 
Reference, covering the Metrowcrks 
implementation of C, C++, and 680x0 
assembly language programming, 
updated for CW7. The Pascal rets also 
include the new UNSJGNEDWORD and 
UNSIGNEDLONG. Also included for this 
time are Profiler and 7oncRangcr Manuals 
updated tor CW8, $34.05 

Inside PowerPlant is the 

Power-Plant Manual, and contains 

information about creating 
PowerPlant applications 
using the CodeWarrior IDE 
and PowerPlant Co ns! motor, 
and describes major 
PowerPlant classes and 
resources Also included arc the 
PowerPlant Constructor Manual, including 




View, TextTraits and Custom Types 
editing, and PowerPlant Library Reference, 
covering ail classes and functions in 
PowerPlant, updated for CW8 $34.95 


New Low 
Price! 


BBEdit 3*5 from Bare Bones Software is 
now better than ever. 
In addition to being 
Accelerated for 
Power Macintosh, this 
powerful, intuitive text editor offers 
integrated support for THINK C 7.0, 
Met'rowerks CodeWarrior 6, THINK 
Reference 2.0 and MPW loolServer. 
Version 3.1 adds even more capability, 
including "soft 11 wrapping of text on screen 
and numerous refinements and 
improvements to the user interlace. 
BBtdil's many features Include: Integrated 
PopupFuncs" technology for speedy 
navigation ot source code files (0, On, 
Pascal, Rez, G8K Assembler, and Fortran), 
unique 'Find Differences 4 command 
(BBEdit can find differences between 
projects and folders as wed as tiles), 
supporl lor Macintosh Drag arid Drop fur 
editing and other common tasks, 
PowerTaik support for reading, sending 
and composition of PowerTaik mail, 
scripting via any OSA compatible scripting 
language including AppleScript arid 
Frontier 3,0, and fast search and replace 
with optional “grep" matching and multi¬ 
file searching BBEdit's rohust feature set 
and proven performance and reliability 
make it the editor ot choice for 
professionals and hobbyists alike. $99 


QC* by Onyx Technology, is a system 
extension that stress tests code during 
runtime for common and not-so-common 
errors. Tests include heap checks, 
purges, scrambles, handle/pointer 
validation, dispose/release checks, write 
to zero, dc-reference zero as well as other 
tests like free memory invalidation and 
block hounds checking. QC is extremely 
user friendly for the nontechnical tester 
yet offers an API for programmers who 
want precise control over testing. QC is 
Also available in Japanese, $99.95 


FaceSpan v2 is an extensible Rapid 
Application Designer (RAD) that makes 
building applications quick and easy. Jl 
combines an interactive, visual interface 
design environment with the object- 
oriented power of AppleScript nr any OSA 
language. Best ul aft, FaceSpan allows 
you lo integrate the capability of 
scriplable programs into your custom 
application Your FaceSpan applications 
can include any number nt windows, 
dialogs, palettes, and menus, hi them, 
you can display scrolling lists, popup 
menus, scrolling text, movies., multi- 
column tables, pictures, icons, buttons, 
and others While no scripting is needed 
lor standard behaviors, every item may 
have its own script. You can even 
program custom objects using Pascal or 
C. Try tbe perfect choice for MIS 
professionals, power users, consultants, 
and programmers. They ¥ FacuSpant 


Includes a royalty-tree distribution 
license, tor unlimited runtime users, of 
your FaceSpan-based applications. Also 
included is a FREE UPGRADE to the next 
version for registered users. $199 

Scripted The Authoring and Development 
Environment lor AppleScriptScripter, the 
Script Construction Set, is the foremost, 
comprehensive tool for creating and 
debugging AppleScript scripts. Scripter is a 
shortcut to Applescript's full capabilities, is 
both powerful and easy to use, and appeals 
equally to novices and experts, Scripter otters 
the larges! collection of tools to answer the 
needs of every AppleScript user, containing 
over 35 features, including: Superior 
vocabulary access point and click 
assembly ot commands and object 
specifications; command window lor 
experimentalfon. Shortcuts and extended 
editing capabilities - extensive drag-and- 
drop, six function find and replace, 
navigation markers; script library ootfeefion 
facility; many other timesavers tor faster 
scripting. Interactive debugging - 
comprehensive variable watcher, expression 
evaluation, enhanced trace log, and real 
single step debugging! Other features 
include, integration with FaceSpan and 
background processing. Unlike other 
scripting tools, which are either based on the 
original Script Editor concept, or are 
designed to look more like traditional 
programming tools, the designers ot Scripter 
understood from Ihe outset that scripting is 
different from writing 0 code. Scripter will 
change ttie way you work with AppleScript. 
From expert script design to user-friendly 
editing and implementation, Scripter is the 
natural companion to AppleScript for ail 
levels uf proficiency. $199 

Macintosh Programmer’s Tool¬ 
box Assistant CD-ROM - Instant 
electronic access to inside Macintosh 
essentials Now Macintosh programmers 
can get quick access to over 4,000 
Toolbox calls that are at the heart of 
Macintosh system software. The 
definitions of these data structures, 
resources, constants, and functions are 
documented in Ihe inside Macintosh 
series and are essential information tor 
anyone developing Macintosh software. 
Macintosh Programmer’s Toolbox 
Assistant is a CD-ROM that harnesses the 
power ul one of the best search and 
viewing engines in Ihe industry, it allows 
programmers to access the Toolbox calls 
quickly from their development 
environment. With hypertext links 
allowing programmers to view related 
tupics easily. Macintosh Programmers 
Toolbox Assistant is Ihe ullirrrate 
electronic reference tool for Macintosh 
programmers. $99.95 

Inside Macintosh 5 : CD-ROM by 

Apple Computer, luc. Inside Macintosh is 
ihe essential reference for prog rammers, 
designers, and engrneers for creating 
applications for the Macintosh family of 
computers, inside Macintosh CD ROM 
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SPECIALS • EXCLUSIVES • HOT ITEMS! 


collects more than 25 volumes in 
electronic form, including: QuickDraw' GX 
Library, Macintosh Human Interface 
Guidelines, PowerPC System Software, 
Macintosh Toolbox Essentials arid More 
Macintosh Toolbox, QuickTime and 
QuickTime Components, Now 
programmers will be able to access over 
16,000 pages of the information they need 
directly Irom their computers. Hypertext 
linking and extensive cross referencing 


across volumes allows programmers to 
search and explore this library in ways 
that are unique to the electronic medium 
Every Macintosh programmer will regard 
Inside Macintosh CD-ROM as their most 
important resource $99,95 

ScriptWizard i 5 is the latest/w. 
version of the best selling script 
editing and debugging fool that 
combines the power ol a professional 


development environment with the ease of 
use that you expect of Macintosh™ software 
Compatible with all Apple® Open Scripting 
Architecture languages, including 
AppleScript, ScriplWizard improves your 
productivity by delivering testing and 
debugging facilities that are as intuitive as 
they are powerful. ScriptWizard makes life 
easier for sciipters by emphasizing features 
M speed script development. Some of the 
most significant enhancements lo sc ri pier 



w 


Advanced Color Imaging 

Do the Mac OS By Apple Computer 

Inc $33,26 

OpenDoc Programmer's Guide 

By Apple Computer Inc. $40.46 

Plan and Manage Web Sites 

on the Mac By Wiederspan/Shotten 

$35.96 

Sex, Lies and Video Games By 

Hensler $31.46 

Tog on Software Design By 

Tognazzlnl $26.96 

See pages 18 & 19 lor more information 




Learn C on The Macintosh 
Second Edition By Dave Mark: See 
page 100 

Tricks of The Mac Game 
Programming Gurus Sea page 100 

Macintosh G Programming 
Primer Volume I, Second 
Edition, Inside the Toolbox 
Using THINK C by Dave Mark and 
Cartwright Reed. This new edition ol this 
Macintosh programming bestseller is 
updated lo include recent changes in 
Macintosh technology, including System 
7, new versions of THINK C and RcsEdit. 
and new Macintosh machines. Readers 
will learn how to use the resources, 
Macintosh Toolbox and interface to create 
stand-alone applications. 672 pages. 
mm $24.25 

Macintosh G Programming 
Primer Volume II, Mastering the 
Toolbox Using THINK G by Dave 
Mark. Volume 11 picks up where Volume ! 
leaves off, covering more advanced topics 
such as: Color QuickDraw. THINK Class 
Library, TextEdit, and the Memory 
Manager. 528pgs. mm $24.25 

Macintosh 0LE2 Programmer's 
Reference: Working with „ 
Objects: Provides a complete^ 
reference to the extensible protocol of 


Object Unking and Embedding, version 
2.01 for Macintosh System 7. 
Understanding of C/C++ helpful, but not 
necessary, and comes with a CD. Working 
With Objects describes the visual and 
interaclice interfaces that support the 
component objects, provides details of the 
OLE 2.01 for the Macintosh user Interface, 
addresses the issues of object class 
registration, shows how to Implement the 
drag and drop objects Srom one 
application lo another, covers the inter lace 
that exposes the basic embedding 
functionality, and includes descriptions of 
API functions &440& $40.45 

Macintosh Pascal Programming 
Primer Volume I, Inside the 
Toolbox Using THINK Pascal by 

Dave Mark and Cartwright Reed This 
tutorial shows programmers new to the 
Macintosh how to use the Toolbox, 
resources, and the Macintosh interface to 
create stand-alone applications with 
Symantec's THINK Pascal. 544 pages 

mm $24.25 

Learn C++ on the Macintosh by 

Dave Mark. After a brief refresher course 
in C, Learn C++ introduces the basic 
syntax of C n and object programming. 
Then you'll learn how to write, edit, and 
compile your first C++ programs through 
a series of programming projects lhal 
build on one another as new concepts 
are introduced. Key C++ con cep Is such 
as derived classes, operator overloading, 
and lostream functions arc ail covered in 
Dave's easy-to-follow approach. 
Includes a special version nt Symantec 
C++ for Macintosh. Book/disk package 
with 3.5" BOOK Macintosh disk, 400 
pages, mm $33*26 

Programming Primer For The 
Macintosh^ Volume 1 by John 
Whittle and Judy May. This book provides 
an introduction to Macintosh 
programming, using C++ as the example 
language, and provides realistic, easy to 
follow, programming examples designed to 
work with either Symantec” C++ or 
Metrowerks 1 " CodeWamof, Also includes 
one 3.5" disk with source code for the 
programming examples, along with 
numerous, useful, public domain utilities to 
use with each compiler. $37.95 $34.15 


Mastering the THINK Class 
Library by Richard Parker. See page 68 

Programming in Symantec C++ 
for the Macintosh by Judy May and 
John Whittle. This book will introduce you 
to object-oriented programming, the 0 h 
language, and of course Symantec C++ for 
the Macintosh. You don’t have to he a 
programmer, or even know anything about 
programming to benelll from this book. 
Programming In Symantec C++ for the 
Macintosh c overs everyth i n g from the 
basics to advanced features of Symantec 
C++. If you arc a Think C or Zortech C++ 
programmer who wants to team more 
about object-oriented programming nr 
what's different about Symantec C++, 
there are chapters specifically for you. 
Includes helpful examples of C++ code 
that illustrate object-oriented programs. 
mm $26.95 

Symantec C++ Programming for 
the Macintosh, Second Edition 

by Neil Rhodes & Julie McKeehan is the 
perfect introduction to C++ programming 
- the most popular programming 
language for the Mad This updated 
edition is toe easiest way to learn C++ in 
the Think environment, using many 
examples and hands-on coding 
experience. The ofllcial Symantec book, 
developed in cooperation with the Product 
Development staff. Provides valuable 
solutions, information, and advice tor 
MPW programmers who are migrating to 
the Think environment. Disk includes 
source code from the book and example 
applications $40.50 

Teach Yourself Mac C++ Pro¬ 
gramming in 21 Gays by Naimr 

Clement Sham mas is the easy-to-follow 
21 day format teaches readers how to 
program in C++ using the Symantec C++ 
compiler. It also shows readers flow to 
develop GUI applications using the latest 
version of the THINK Class Library (TCL). 
Targets Symantec C++ 7 0, one of the 
hottest programming languages and 
development environments. Discusses the 
basics of programming lor the Mac using 
TCL and the Visual Architect uiilily. Uses 
notes, tips, and warnings, as well as Q&A, 
Quiz, Exercise, and Do/Don't sections to 
teach users the C++ programming 


productivity include tee ability to single-step 
scripts (now allowing true statement-level 
stepping), watch variable values as scripts 
execute, jump instantly to frequently used 
places in a script and find and replace specific 
text. Full drag and drop text editing is 
supported. ScriptWizard delivers an intuitive 
development, testing and debugging 
environment for rapid script creation with 
essential too Is up-front tor easy access. $B9 


P ++ 6 


language. &09 $26,99 


Writing Locaiizable Software 
for the Macintosh by Daniel R. 
Carter. 469 pages, mm $24,25 


Global Interface Design, 

A Guide to Designing 
International User 
Interfaces by Tony Fernandes, AP 
Professional, Global Interface Design 
addresses If re issues involved in product 
development lor a global market with a 
"real world" locus.. While covering major 
areas developers should address during 
the development cycte, Tnny Fernandes 
provides insight into researching cultural 
(inferences. This book examines the 
differences found all over the world, such 
as cultural symbolism and taboos, and 
how they impacl user interfaces. $34-95 
$32.35 


Tafigent’s Guide to Designing 
Programs: Well-Mannered 
Object-Oriented Design in C++ 

SAW $17,55 Call for more 
information. 


Software By Design: Creating 
User Friendly Software by Penny 
Bauersfetd (Series Editor- Tony Meadow), 
This excellent reference provides readers 
with a thorough how-to lor designing 
software that is easy to learn, com for table 
to operate and that inspires user 
confidence. Written from the perspective 
of Macintosh, but compatible with all 
platforms. Stresses user input from initial 
design, through prototyping, testing arid 
revision. Provides tools ter analyzing user 
needs and test responses Includes 
exercises for sharpening user-oriented 
design skills, mm $26,95 

Macintosh Programming Tech¬ 
niques by Dan Sydow (Series Editor- 
Tony Meadow). This tutorial and 
handbook provides a thorough foundation 
in the special techniques of Macintosh 
programming for experienced Macintosh 
programmers as well as those making the 
transition Irom DOS, Windows, VAX or 
UNIX. Emphasizes programming 
techniques over syntax for better code, 
regardless of language. Guides the reader 
through Macintosh memory management. 
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QuickDraw, events arid more, usirrg sample 
program in C++ Disk includes an 
interactive tutorial, plus reusable C++ code 

mm $31.95 

More Mac Programming 
Techniques: More 
Programming Techniques goes beyond the 
fundamentals of Macintosh programming 
With this hands-on guide and tutorial, 
you’ll expand m tire basic foundation of 
programming to develop truly powerful 
applications. Inside you will take a detailed 
took at the units of a Macintosh program - 
from the INITs to custom controls Along 
the way, you'll learn solid techniques you 
can apply anywhere, including tricks and 
techniques. You will learn file resources 
Irom the ground up, and how to build 
custom menus, add custom controls, 
including buttons, and slider controls, 
MDEF, and CDF resources. The book wilt 
also help you to handle IMITs, making 
preference tiles, and how to print flawlessly 
from your programs. $35,95 

Macworld Ultimate 
Mac Programming by HOT 

Dave Mark, Reveals the ITEM! 
secrets of Mac programming 
and presents important, timesaving 
techniques. $35.95 

Mac Screamer, The Ultimate 
Macintosh Supercharging Kit try 

Jan Harrington covers 30 Macintosh models, 
including the Classics, LCs, PowerRooks, 
and Quadras and gives software solutions 
and hardware tips to accelerate Mac 
performance, It lets readers in on do-it 
yoursetl tips liiat can save them over 25% on 
upgrade costs mm $31.50 

Programming for System 7 by Gary 
Little and Tim Swihart, Is 3 hands-on guide 
to creating applications far System 7. It 
describes the new features and functions of 
the operating system in detail. Topics 
covered include file operations, cooperative 
multitasking, Balloon Help, Apple events, 
and the Fite Manager, Numerous working 
0 code examples show programmers how 
to lake advantage ol each of Wiese features 
and use them in developing their 
applications, 384 pages, mm $24.25 

Guide to Macintosh System 7.5 

by Don Crabti. Written by an industry 
expert, this is the first thorough book on the 
new and improved Macintosh operating 
system. Readers will learn all the highlights 
of the new System, including how to work 
efficiently with applications, intuitive, task- 
oriented approach teaches topics the way 
users think, not the way the machine thinks. 
Covers all the new features of System 7,5. 
including PowcrTalk. PC Exchange, and 
MacTCP Written by a world-renowned Mac 
expert, mm $22.50 

A Fragment of Your imagination 

by Joe Zobkiw See page 101 

How To Write Macintosh Software 

by Scull Knaster is a great source for 


understanding Macintosh programming 
techniques. Drawing from his years of 
experience working with programmers, Scott 
explains the mysteries and myths of 
Macintosh programming with wit and humor. 
The third edition, fully revised and updated, 
covers System 7 and 32-bi! developments, 
arid explores such topics as how and where 
things are stored in memory: what things in 
memory can be moved around and when they 
may be moved; how to debug your 
applications with MaosBug, how to examine 
your program's code to learn precisely what's 
going on when it runs. 448 pgs mM 
$26.05 

Danny Goodman's Macintosh® 
Handbook Featuring System 7 by 

Danny Goodman with Richard Saul Wurman, 
It includes over 100 spreads break down and 
clarity Mac problems and includes insider's 
tips, mm $26.95 

Heal World Apple Guide, 

For The Mac is the muchTfj^ 

anticipated help and navigational aid 
component of tile new Apple System 7.5 
OS. The book is a practical introduction to 
Apple Guide for programmers. It explains 
the design arid function ol Apple Guide,, 
how to design your own guides using Apple 
Script. Comes with a disk of sample Apple 
Guides for Apple Guide-compliant 
applications $ 30-95 $ 35 . 95 . 

Danny Goodman's 
Apple Guide Starter Kit hut 

by Danny Goodman and ITEM! 
Jeremy Joan Hewes. Two 
highly respected experts offer a different 
approach for creating your own Apple Guide 
databases With Danny's Guide Starter 
program you can make guides quickly and 
easily, without having to team a scripting 
language write coded files, or use several 
different fries and programs to produce your 
database (which is what you'd have to do 
without the program). Tire authors provide 
advice and tips on how to design a good 
Guide, from planning and creation through 
testing, revising, and indexing. Book/disk, 
320 pages, mm $31.46 

HyperTalk 2.2: The Book Second 
Edition by Dan Winkter. Scott Kami ns, and 
Jeanne DeVoto is the most complete, 
authoritative source on HyperTalk 2.2 
programming and troubleshooting. It 
covers each language element of HyperTalk 
2.2 (including the odd quirk or bug), 
mm $31.50 

The Complete HyperCard® 2,2 
Handbook Fourth Edition by Danny 
Goodman is the biggesl-selling Mac book 
- newly revised and updated for version 
2.2. It shows how to build working 
applications using the latest version of 
HyperCard and covers text, painting toots, 
extension commands (XCMDs), scripting 
in HyperTalk, and more, SM; $31.50 

Dan Shafer Presents the Power of 
Pragraph CPX is a hands-on, project- 
centered approach to learning the most 



revolutionary object-oriented 
HOT program ming language on the 
ITEM! planet. The language Kurt 
Schmucker likes best. The 
language that programmers actually report 
having “fun" programming This 550 page 
book takes you step by step through three 
interrelated projects ot increasing complexity* 
Along the way you'll learn the under lying 
Prograph language, how to use the power of 
lists, and the important aspects of the CPX 
classes and obienl editors Includes disk with 
all code in the book. $49.05 $44.95 

Visual Programming With />K. 
Prograph CPX by Scott B 
Stein mao and Kevin G. Carver. This is the 
first book on ProgFaph GPX available 
through the book trade, It covers Ihe only 
commercially supported visual programming 
language at a lime when many programmers 
and managers, faced with continuing 
productivity problems, ore searching for 
better programming environments. Pragraph 
CPX is much more than such GU (-enhanced 
traditional languages as Visual Basic: II 
literally allows you to draw your program 
flow using icons and create a complete 
application without writing a line of code, 
This hook is an introduction to the language 
and a guide for advanced users, lor tooth 
Macintosh and Windows-based machines. 
Prograph is a fully pictorial, general-purpose, 
object-oriented language that speeds 
development with an integrated cnvironmenl 
tor design, coding, testing and debugging; 
with its DO framework for sophisticated GUI 
development; with its support tor calls from 
C. C++, Pascal, and other routines; with its 
DAL. ORACLE. Sybase, AS/400 client/server 
DB support; and many other powerful 
features. $30.60 

Graphic Gems V Edited by Atari W 

Paeth is the newest volume in The Graphic 
Gems Series, If is intended to provide the 
graphics community with a set of practical 
toots for implementing new ideas and 
techniques, and to offer working solutions 
to real programming problems. These tools 
are written by a wide variety ot graphics 
programmers from industry, academia., and 
research. The books in this series have 
become essential> time-saving toots lor 
many programmers. 11 is the latest 
collection ol graphics tips in The Graphic 
Gems Scries written by the leading 
programmers in the field, ft contains about 
5Q new gems displaying the most recent 
and innovative techniques in graphics 
programming, Also included is new gems 
in ellipses, splines, Bezier curves, and ray 
tracing. includes a disk which contains 
source code from all five volumes and is 
available in both IBM and Macintosh 
versions. CONTENTS: Algebra and 
Arithmetic. Computational Geometry. 
Modeling and Transformation. Curves and 
Surfaces. Ray Tracing and Radiosity. 
Halftoning and Image Processing. Utilities. 
g g $44.35 

Applied Mac Scripting /h. 

Applied Mac Scripting covers 



AppleScript™, Frontier, QuicKcys, Tempo 
It,. nShell, FaceSpan Application Builder, 
Scripting PlainTalk and System 7.5. With 
this hands on tutorial Tom Trinko shows 
you how to automate your Macintosh 
activities by learning how to use the 
AppleScript and Frontier scripting 
environments. You will learn the overall 
approach to designing and developing 
powerful scripts, and to harness the 
capo bit dies of a wide variety of Macintosh 
applications into the integrated 
productivity tools. This includes such 
things as trie newspaper script which 
combines the power of SITcornm, 
MacWrite Pro, and Fiiemaker Pro, or 
QuarkXPress. Whether you are a power 
user or experienced Mac Programmer you 
will learn valuable new techniques tor 
Mac automation, $34.05 $31,45 

Danny Goodman’s 
AppleScript Handbook HOT 

Second Edition by Danny ITEM! 
Goodman is a self-contained 
kit shows the reader how to customize and 
extend the capabilities of any Macintosh 
computer - no programming experience 
needed! This enhanced and expanded 
edition ot The Complete AppleScript 
Handbook focuses on putting AppleScript 
to work in ail sorts of practical situations. In 
addition, Danny shows you how to apply 
the same principles to other popular 
scripting systems, such as UserLand 
Frontier and QuicKeys, Shows readers how 
to use scripts to enhance the Macintosh 
environment, automate many processes, 
link data between applications, and much 
more. This hook provides a wealth of all- 
new examples showing how to integrate 
AppleScript with the Finder, spreadsheets, 
desktop publishing programs, graphics 
applications, databases, 

telecommunications programs, utilities, and 
HyperCard, The accompanying 3 1/2" disk 
Is fam packed with over $100 worth of 
software, including AppleScript 1,1, 
valuable utilities, and power tut, ready-lo¬ 
use scripts. S3Q.00 $35.00 

The Complete AppleScript® 
Handbook by Danny Goodman is a sell 
contained kit to customizing mi 
HOT enhancing tire Macintosh 
ITEM! environment. The disk contains 
' AppleScript 1.1 Runtime, Chang 
Labs TabtcScrvcr, and useful, ready to-run 
scripts. It also shews the Mac user how to 
automate many processes - no programming 
experience necessary mm $31.50 

The Tao af AppleScript: BMUG’s 
Guide to Macintosh Scripting, 
Second Edition by Derrick Schneider ft 
Hans Hansen. This updated bestseller is a 
complete, natural introduction to AppleScript 
programming essentials. Readers team how 
to customize applications, automate tedious 
tasks, and create programs without having to 
use a complex programming language. 2 
disks contain AppleScript, QuickTime, Stuff!I 
Lite, ResMover, and other helpful utilities 
Progressive structure meets the needs of any 
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Mac user, regardless of experience. 
Professional insfmcllons are mixed wilfi 
practical examples for easy teaming $0006 

$26.95 

Wireless For Ttie Newton 
Software Development for 
Mobile Communications by Julie 
McKeehan and Neil Rhodes is 
HOT a book that picks up where 
ITEM! Programming for ttic Newton 
left off. teaching the reader 
how to develop Newton* software on the 
Macintosh. [he enclosed floppy disk 
provides a sample application, as well as 
a fully lunclional demonstration version 
Of Newton Toolkit” (NT1C), Apple 
Computer s complete development 
environment lor the Newton*, Gives 
hands-on Newton environment training 
wilh sample code created specifically for 
the Newton* The authors are external 
faculty at Apple Developer University 
leaching clams on programming lor lire 
Newton*. Programming experience is 
assumed, although nol in any particular 
language. Enclosed is a floppy disk which 
contains source code for a Newton 
application, as well as demonstration 
NIK" mm $31 45 

Basic For The Newton 

Programming lor the Newtonip^ 
Using NS Basic by John Schetlino SLiz 
O'H ara This book shows owners of 
Newton devices how to become Newton 
programmers using BASIC the a nil ms 
use a straight-forward “programming by 
example" approach, which should have 
you writing your own Newton programs 
right away It includes one 3 5" disk 
containing Demons!ration NS BASIC and 
over fifty example programs from the 
book ll is Multi-platform in thai teaches 
programming for the Newton using a 
Macintosh a Windows-based PC, or on 
the Newton device itself, mm $32.35 

Programming for the Newton 
Software Development with 
NewtonScript by Julie McKeehan and 
Neil Rhodes foreword by Walter R. 
Smith. Programming tor the Newton: 
Software Development with NewtonScript 
is an indispensable loot for Newton 
programmers. Readers will learn how to 
develop sofiware for ihc Newton on the 
Macintosh from people that developed the 
course on programming I he Newton tor 
Apple Computer. The enclosed 3,5“ disk 
contains a sample Newton application 
from the hooks, as well as demonstration 
version ol Newton Toolkit (NIK), Apple 
Computers complete development 
environment lor the Newtons A 
Publication of AP Professional May 1994, 
Paperback. 393 pp mm $26.95 

Metrowerks CodeWarrior Pro¬ 
gramming by Dan Parks Sydow. 
Includes CodeWamor Lite, 
HOT and Full Coverage of 
ITEM! Power Plant rw The best 
information on Metrowerks 


CodeWamor 6. giving lull coverage to the 
GoEd Edition Even if you don't already 
own CodeWarrior 6. youll still be able 10 
work with the examples in this book, 
using the CodeWarrior 6 Lite CD Ibat 
comes with it. $3 9 ti fr $35.95 

C++ Programming With 
CodeWarrior Beginning HOT 
OOP for the Macintosh and ITEM! 
Power Macintosh by Jan L. 

Harrington hum AP Professional This 
book shows programming novices object- 
oriented programming techniques for the 
Macintosh, Power Macintosh, and Mac OS 
compatibles, using C++ as I he example 
language and Melrowerks and 
CodeWarrior as I tie example compiler. The 
enclosed CD-ROM contains example code 
from the book and a full-function 
Metrowerks CodeWarrior compiler for 
running these examples. $ AS Q5 $32.35 

Optimizing PowerPC Code: 
Programming the PowerPC in 
Assembly Language To fake foil 
advantage of the potential of 
H0T the PowerPC, Developers 
ITEM! to master lire Assembly 
Language techniques This 
book shows how to use the Assembly 
Language in PowerPC Programs to 
produce faster more robust software, 
mm $35.96 

Inside Code Warrior 7: See page 101 

Inside PowerPlant: See page 101 

Power Macintosh Programming 
Starter Kit by lorn thnmpson. this is 
the Eirst tutufial/rettf eriee for programmers 
who want to enter the new world ol the 
PowerPC chips Users find all the details 
on the new microprocessors, I he new 
RISC architecture, and how To write native 
code and emulation operations to create 
their own software lor Ihe Macintosh 
PowerPC CD-ROM includes a unique 
compiler for writing code easily The all 
in -one book that gets programmers the 
information and tools limy need. 
Programming examples reinforce 
explanations of code and programming 
tools W $35.10 

The ResEdit All Night Diner try 

□avid Ciskowski. An idea-filled menu and 
Introduction to Ihe joys of customizing 
software - and adding personality lo the 
Mac with ResEdit I Shows readers how to 
customize default icons, the texl nf menus 
and dialog boxes, cursors, pointers, and 
more. Provides specific recipes lor doing 
creative things with ResEdit - plus how to 
avoid problems Disk features ResEdit 
program, plus lots of sample resources 
mm $22.45 

ResEdit" Complete, Second 
Edition by Peter Alley and Carolyn 
Strange Wilh ResEdit, Macintosh 
programmers car customize every aspect 
of their interface form creating screen 


backgrounds and icons to customizing 
menus and dialog boxes. 608 pages 
Book/disk package mm $31,45 

Sad Macs, Bombs, Disasters 
and What to Do About Them by 

Ted Landau conies to the rescue wilh your 
Macintosh problems. From fractious fonts 
to the ominous Sad Macintosh icon, this 
emergency handbook covers Ihe whole 
range of Macintosh problems symptoms, 
causes, and what you can do to solve 
them, 640 Pages mm $22.45 

Macintosh" Crash Course by 

Glenn Brown shows Macintosh power 
users whal to do when things go wrong 
wilh their system. Macintosh Crash 
Course shows readers how to overcome 
Macintosh system crashes, system lock¬ 
ups. and various, frustrating and cryptio 
error messages Itisy regularly encounter. 
II includes a CD-ROM wilh shareware and 
freeware to help the user diagnose and 
repair system failures. Includes up-lo date 
coverage through Macintosh System 7.5 r 
Managing memory. Hardware diagnostics, 
File recovery, PuwerBouk problems. 
PowerPC problems, network utilities, Ivard 
drive repair utilities, SCSI problems, conflicts 
and solutions and File synchronization and 
utilities, mm $26,95 

Multimedia Authoring: Building 
and Developing Documents by 

Scon Fisher addresses the concerns that 
face anyone trying to create multimedia 
documents It offers specific advice on 
when to use different kinds ol Jnfomtiion 
arnhifecture, discusses Ihe human-laclorc 
concepts thal determine how readers use 
and retain information, and them applies 
these findings to muttimedia documents, 
covering the high-level issues concerning 
planners and authors ol multimedia 
documents as weft as those involved in 
evaluating or purchasing multimedia 
platforms Includes one 3.5* high-density 
disk mm $31.45 

Multimedia Starter Kit for 
Macintosh by Michael D Mur re This 
hands-on book offers the latest and 
greatest in multimedia lor the Mac! 
Readers learn hnw to design Iheir own 
multimedia projects step by step, Iheri try it 
themselves with Ihe demos, graphics, 
dips, and sample projects on the CD- 
ROM! CO-ROM contains QuickTime, 
sound and graphics clips and utilities, 
sample projects, and more. How to choose 
and use a variety of Macintosh multimedia 
fools and presentation environments 
Includes demos of Adobe Illustrator. 
Premiere, Heizer Software programs, and 
more mm $27 DO 

QuickTime Starter Kit for 
Macintosh by Robert A Lettien & 
Judilh Stern. This Is the ultimate package 
for getting productive and having fun wilh 
Macintosh movie making Easy steps and 
valuable software help readers play, 
make, arid edil QuickTime movies. CD- 


ROM includes QuickTime tools, mnvie 
dips, shareware, and demos o! Premiere 
and oilier programs Written by members 
ol Ihe respected Berkeley Macintosh User 
Group Tips on the best ways to bring 
live-action video to Mac multimedia 
mm $40.50 

3-D Starter Kit for Macintosh by 

Sean Wagstaff. The complete reference to 
3-D graphies on Ihe Macinlosh ideaI for 
beginning to intermediate product 
designers, illustrators, graphic designers, 
multimedia developers, animators, and 
video producers, as well as architects and 
engineers! Covers more than 50 major 
Macintosh 3-D Imaging software 
packages the most comprehensive bonk 
available Lois nt idea-packed examples 
ttial illustrate how 3-D products work - 
individually and logelher CD-ROM 
Includes sample models, image galleries, 
backgrounds, and textures, plus 3 D 
software tryout versions $10 00 $36,00 

The Instant Internet Guide by 

Brenl Hesiup and David Angel I. An Internet 
jump-starl - how to access, use and 
navigate global networks The Instanl 
Internet Guide equips readers wilh the 
tools needed to have! ttie electronic world. 
The book highlights the most important 
sources of interne! news and inlormalion 
and explains how to access information on 
remote systems ft outlines how to use 
essential Internet Utilities and programs 
and includes a primer on UNIX lor Ihe 
Internet 224 pages mm $13.45 

Internet Power Toots by John Ross 
is designed for intermediate PC users, 
Internet Power Tools is a complete 
hook/disk package that allows access to 
tlie world's largest network - Ihe Internet - 
wilfi toe same ease as one uses Windows. 
The detailed instructions allow readers to 
find their way around the Internet last and 
covers e-mail, file transfers, remote logon, 
on-line directories, and more The 
accompanying disk is packed with powerful 
utilities, including Cello, PC Eudora, and 
Panda - easy-to-use graphical user 
Interlaces (GUI) that obviate Ihe need tor the 
obscure Unix line commands M everyone 
else must learn. It also provides access lo 
even more sofiware via Random House’s 
Internet FTP site and shows how to conned 
to the Internet via a network connection or 
dial in mm $36.oo 


Web Head; The Mac 
Guide tc the Worfd Wl<te^_ 

Web by Mary Jane Mara Published by 
PcachPif Press This is a beginning to 
intermediate bnok fftai shows you how to 
gel the most Irorn Ihe Web. using plain 
talk that beginners will understand, and 
online veterans will appreciate, Web Head 
also includes in depth tours ot the three 
leading Web browsers ter tee Macintosh: 
Netscape, Mat:Web, and MaoMusaic, and 
explains Ihe basics behind all Web 
browsers - so you will be ready even 
when the next hoi Web browser hits Ihc 
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scene It will also fell you how to pi 
connected to ihe Wet) finding your way 
across webspace, line-tuning your Mac 
lof top Weti performance, and bow to turn 
your Mac into a multimedia Web browser 
There is also instruction on how to build 
your own home pap. posting pages on 
the Web, and avoiding common HTML 
mistakes mm $22 45 

The Underground Guide to/^w 
Telecommuting by Woody 
Leonhard. Addison Wesley I hare’s no 
place like home Especially when your 
boss, your kid, and ihe neighbor's dog are 
all bdrknig tor your attention 

simultaneously Working away Irorn a 
corporate of lice presents great {often 
unexpected) challenges ami niters even 
greater rewards Wuudy Leonhard lakes on 
the toughesl aspects of lelecorninuting and 
gives you the straight scoop on how to 
make u work for you Whether ypu'rc a 
fclecommutnr, a telecommuters boss, or 
just curious. The Underground Guide to 
Tetamniuling will give you Itie tools and 
inJormabon you need to lum electricity and 
a phone line into major productivity 
$2245 


The Elements of E-Mail Style uy 

Brenl Heslop and David Angcll team Ihe 
rules of ihe road in the e-mail age. 
Concise, easy to use format explaining 
essential e-mail guidelines and rules It 
covers style, lone, typography formatting., 
politics and etiquette It also outlines basic 
rules of composition within the special 
context of writing c mail and includes 
samples and tempfeJas fro wring specific 
types ol e-mail correspondence 20B 
pages. » $13.45 

E-Mail Essentials by Fd Tittet & 
Margaret Robbins is a hands on guide to 
Ihe bastes of e-mail, the ubiquitous 
networks communication system The 
book is suitable lor both the casual e- 
mailer and the networking professional, as 
it covers everything from Ihe Installation 
ol e-mail to ihe maintenance and 
management ol e mail hubs and message 
servers. Hie books explains the 
fundamental concepts and technologies 
of electronic mail, featuring chapters on 
Lotus applications and CompuServe, as 
well as information on upgrading, 
automation, message-based applications, 
and user training. E-mail Essentials is a 


step-by-step, jargon-tree guide dial will 
enable the e-maif user lo gel the most out 
ol rite communication potentials of 
networking 250 pp mm 32245 

The Computer Privacy 

hot Handbook is a practical 
ITEM! guide lo e-mail encryption, 

dala protection, and PGP 
privacy software With millions of c 
mail messages and on line discussions 
exchanged dally on the Internal 
electronic sRcurlty has become a key 
concern Hie Computer Privacy 
Handbook explains practical steps 
individuals can lake to safeguard tticir 
electronic security It also gives a vivid 
description ol how Ihe "Surveillance 
Age" ihrealnrifi each person's personal 
security, a non-teclinreal introduction 
Into data encryption, and ihe U S 
Government's Clipper Chip surveillance 
proposal It also provides an overview 
of PGP. (Pretty Good Privacy), the 
world standard lur e-mail privacy 
mm $2245 

PowerPC System /fo. 
Architecture by MmdSfoar 


This book describes the hardware 
architecture of PowerPC systems, 
providing a dear concise explanation ol 
the PowerPC specification, the template 
upon which alt PowerPC processors are 
designed The author provides a compile 
description of the specificafion for both 
the 32- and 64 bit impfementattons 656 
pages IMM $3146 

PCI System Architecture, /v. 
Third Edition by MmdShar- 
Describing revision 2.1 ol the Peripheral 
Component Interconnect (PCI) bus 
specification, this hnnk explores PC I s 
relationship to the rest ol the system If 
mutinies an in-depth Irealment ol PCI to 
PCI bridges, the PCI BIOS, the 66MH? 
PCI bus, and more, 59? pages mm 
$3146 

Cyberpunk Handbook, 

The heal Cyberpunk W 
Fakebook by St Jude. R U Sirius, and 
Bart Nagel Published try Random House. 
This book tells how to tell It you or 
someone you know is a Cyberpunk. 

$8.95 


THE APPLE LIBRARY 


Learn C on Late Night /v. 
With MacHack covers the 
MacHack conferences from then inception 
hi 1936, up to 1993 Doug Houseman is 
Ihe program Chairperson of Mad lack, and 
the author of this book the 
accompanying CD contains om UK) ol 
I lie best hacks written at MacHack ovei the 
years, including The Grouch, Net Bunny, 
Jurassicon Park, DropSave. QuickTime 
Balloon Help, the Mac Clapow, Wavy- and 
more $3M6-$2§J5 

Advanced Color Imaging 

On the Mac OS explains how v&i? 
you can augment the color suppnrl 
supplied with Quickdraw, and 
OutefcdrawGX, using ihe Palette manager 
to provide the best set of colors on 
displays with limited color capabilities, 
soliciting the color choices from users wiih 
the color Picker Manager/ Using the 
Color Sync manager lo match colors 
between screens and input arid output 
devices such as scanners and primers/ 
learning how ihe color Manager assists 
Color QuickDraw m mapping an 
applications color requests to the actual 
enters available mm $33.25 

3D Graphics Program-/^ 
ming Using QuickDraw 3D 

by Apple Computer Inc Now you can 
incorporate spectacular 30 graphics mlu 
your applications. This book/CD-RQM 
package explores QuickDraw 3D, a 
graphics extension to the Mac OS tor 
Power Macintoshes The CD contains Ihe 
complete QuickDraw 3D system itsell and 


a complete database of the QuickDraw 3D 
API, allowing you instant access to the 
hundreds ot graphics calls via a last 
viewing engine Book/CD-RQM. 640 
page M $35,96 
Tricks of The Mac Game Pro¬ 
gramming Gurus: See page 68 

Apple Guide Complete by 

Apple Computer, Inc. fur those 
who want the lull power of Apple s 
complete toolset, this book and CD-ROM 
package from Apple provides everything 
you need to produce guide Mies 
successfully. Including Guide Maker, the 
setae you use Eo build and lest guide 
tiles. You'll learn about the complete 
cycle of designing as well as advanced 
topics such as scripting and coding guide 
fries Book/CD ROM, 544 pages mm 
$ 35.96 

Inside AppleTalk by Gursharan S 
Stdhu Richard F Andrews and Alan B 
Oppenteimer Apple Computer, Inc 650 
pages mm $3145 

AppleScript Finder 
Guide, English Dialect, by HOT 
Apple Computer. Inc The ITEM! 
AppleScript finder Guide is 
an essential re I ere nee for anyone who 
wants to use AppleScript on a Mac to 
modify existing Finder scripts or to write 
new ones The Finder scripting software 
allows you to write, record, or run scripts 
that trigger the same desktop actions LHat 
you trigger using Ihe keyboard and 
mouse- actions such as opening and 


dosing lowers or manipulating files This 
hnok introduces Finder scripting and 
describes how lo record and modify 
simple scripts In particular, it provides 
definitions tor Finder object classes anil 
commands Use of this book requires dial 
AppieScripl tie installed, and you should 
bn lamihar wilh AppleScript Scripting 
Additions Guide, and AppleScript 
Language Guide $17.95 

AppleScript Language 

Hot Guide, by Apple Computer 
ITEM! Inc The AppleScript I an ft 

uage Guide is the definitive 
description of the Fngllsh dialed nt the 
AppleScript scripting language Hus 
book is an essential retarwice for anyone 
using AppteScnpl lo modify existing 
scripts or lo write new ones It also 
contains useful information lor 
programmers who are working on 
scnptabte applications or complex 
scripts this book begins with an 
introduction to tripling and an overview 
ot AppteScnpFs main features Most at 
toe book consists of detailed definitions 
Of AppleScript terminology and syntax m 
Ihe following categories Value classes, 
commands, objecls and references to 
objects, expressions, control statements, 
handlers and scrip! objects In addition 
to detin it ions the book provides many 
sample scripts and discusses advanced 
topics such as wrtofig command handler 
tor script applications, the scope of script 
variables and properties declared at 
different levels to a script, and Inheritance 
and delegation among script objects, lu 


get the most out ot this book, you only 
need to be lamihar with Macintosh 
computers Although out required some 
previous expeneuce wilh another 
script mg language (such as HyperTalk) is 
also helpful mm $26.95 

AppleScript Scripting 
Additions Guide, by HOI 

Apple Computer, Inc ITEM! 
AppleScript Scripting 
Additions Guide is the deMnitive 
description ot the scripting additions Eiial 
accompany Ihe English dialed ol Ihe 
AppteScnpl scripting language Scripting 
additions ate tiles that extend 
AppleScript's capabilities by providing 
the additional commands or coercions tor 
use in scripts This book is an essential 
reference tor anyone using AppleScript to 
muddy existing scripts or write new ones. 
li also contains information for 
programmers who want to write scripting 
additions The Scripting Additions Guide 
is also a how to install any scripting 
additions and invoke their commands, to 
use the standard scripting additions 
commands, or to write scripting 
additions mm $ 17 . 05 . 

HyperCard Stack Design Guide¬ 
lines by Apple Computer tnc >s an 
essential book tor everyone who creates 
Apple HyperCard stacks, from beginners 
to commercial developers tt covers rite 
basic principles ot design lhat. when 
Incorporated, make HyperCard Slacks 
ellechve and usable Topics include 
guidelines, navigation graphic design 
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and screen illustration, tent in slacks, 
music and sound, a sample stack 
development scenario, collaborative 
development, and the Stack Design 
Checklist 240 pages M $19.95 

Macintosh Programmer's Tool¬ 
box Assistant CD-ROM: See page 101 

Inside Macintosh*’: CD-ROM: Sec 

page 102 

Inside Macintosh": Overview by 

Apple Computer. Inc, Is the first book that 
people who are unfamiliar with Macintosh 
programming should read. It gives an 
overview of Macintosh programming 
fundamentals and a road map to the New 
Inside Macintosh library, Inside 
Macintosh; Overview also covers various 
programming tools and languages, 
compatibility guidelines and an overview 
of considerations for worldwide 
development, 176 pages S2&& $29.65 

Inside MacintoshFiles by Apple 
Computer, tnc. (describes the parte of the 
Operating system that allow you to manage 
files. It shows how youi application can 
handle the commands typically found in a 
Fite menu, It also provides a reference to 
the File and Alias Managers, Ihc Disk 
Initialization and Standard File Packages, 
510pgs U $26.95 

Inside Macintosh 4 : Operating 
System Utilities by Apple Computer, 
Inc, describes parts ol the Macintosh 
Operating System that allow you to manage 
various low-level aspects of the operating 
system Everyone who programs the 
Macintosh should read this book 1 IE will 
show you in detail how to get information 
aboul the operating system, manage 
operating system queues, handle dares and 
times. control the settings ol the parameter 
RAM, manipulate the trap dispatch table, 
and receive and respond to low-level 
system errors $23.45 

Inside Macintosh : Processes 

by Apple Computer. Inc, describes the 
parte of the Macintosh operating system 
that allow you to control the execution of 
processes and interrupt tasks. It shows in 
detail how you can use the Process 
Manager to gel information about 
processes loaded in memory, It is also a 
reference for the Vertical Retrace. Time, 
Notification, Deferred Task, and Shutdown 
Managers 208pages $20,65 

Inside Macintosh* 4 : Memory by 

Apple Computer. Inc describes Ihe parts at 
the Macintosh operating system that allow 
you 1o manage memory It provides detailed 
strategies lor allocating and releasing 
memory, avoiding low memory situations, 
reference to Ihe Memory Manager. Ihe 
Virtual Memory Manager, and memory- 
related utilities 296 pages $22.45 

Inside Macintosh 4 : AOCE 
Application Interfaces by Apple 


Computer, Inc, shows how your application 
can lake advantage ol the system software 
features provided by PowerTalk system 
software and the PowerShare collaboration 
servers Nearly every Macintosh application 
program can beneiil from the addition of 
some of these features, This book shows 
how you can add electronic mail capabilities 
to your application, write a messaging 
application or agent, store information in 
and retrieve information from PowerShare 
and other AOCE catalogs, add eataiog- 
browsing and flnd-in-catelog capacities lo 
your application, write templates that extend 
the Finder’s ability lo display information in 
FoworSbarc and other AOCE catalogs, add 
digital signatures to fifes or lo any portion of 
a document and establish an authenticated 
messaging conned ion, $36.40 

inside Macintosh: AOCE 
Service Access Modules by Apple 

Computer, Inc, describes how to write 3 
software module that gives users and 
PowerTalk-enabled applications access lo 
a new or existing mail and messaging 
service or catalog service. This book 
shows how to write a catalog service 
access module (CSAM), a messaging 
service access module (MSAM), and 
AOCE templates that allow a user In set up 
a CSAM or MSAM arid add addresses In 
mail and messages. $24,25 

Inside Macintosh 4 : Devices by 

Apple Computer. Inc. describes how lo 
write scltware that internals with built-in 
and peripheral hardware devices. With 
this book, you'll team how to write and 
Install your own device drivers, desk 
accessories, and Chooser extensions: 
communicate will device drivers using 
the Device Manager; access expansion 
cards using the Slot Manager: control 
SCSI devices using SCSI Manager 4,3 or 
the original SCSI Manager; communicate 
directly with Apple Desktop Bus devices. 
Interact with the Power Manager in 
battery-powered Mad ulus 1 1 computers; 
and communicate with serial devices 
using the Serial Driver M $26.95 

Inside Macintosh" 5 : Macintosh 
Toolbox Essentials by Apple 

Computer, Inc. covers Ihe heart nl the 
Macintosh The toolbox enables 
programmers to create applications 
consistent with the Macintosh "look and 
led™. This book describes Toolbox 
routines and shows how to implement 
essential user interface elements, such as 
menus, windows, scroll bars, icons and 
dialog boxes 880 pages $31,45 

Inside Macintosh": More Mac¬ 
intosh Toolbox by Apple Computer 
tnc. covers other Macintosh leatures such 
as how to support copy and paste, 
provide Balloon Help, play and record 
sound and create control panels are 
covered in this volume The managers 
discussed include Help, List. Resource. 
Scrap and Sound. $344& $31.45 


Inside Macintosh*: Networking 

by Apple Computer, Inc. describes how lo 
write software that uses AppleTalk 
networking protocols, I! describes the 
components and organization of 
AppleTalk and how to select an AppleTalk 
protocol it provides the complete 
application interlaces Eo all AppleTalk 
protocols, including ATP (AppleTalk 
Transaction Protocol), DDF (Datagram 
Delivery Protocol), and ADSP (AppleTalk 
Data Stream Protocol), among others. 
mm $26.95 

Inside Macintosh 4 : Interap¬ 
plication Communication by Apple 
Computer, Tnc. shows how applications 
can work together How your application 
can share data, request information or 
services, allow the user to automate tasks, 
communicate with remote databases 
mm $31.45 

Inside Macintosh*: PowerPC 
Numerics hy Apple Computer. Inc. 
describes the floating-point numerics 
environment provided with the first release 
ol FowerPC processor-based Macintosh 
computers The numerics environment 
conforms to the IEEE standard 7b 4 for 
binary floating-point arithmetic. This book 
provides a description of that standard 
and shows how RISC Numerics compiles 
with it. This bonk also shnws 
programmers how to create lloatfng-puinl 
values and how to perform operations on 
floating-point values In high-level 
languages such as 0 and in PowerPC 
assembly language SM $26.00 

Inside Macintosh *: PowerPC 
System Software by Apple 

Computer, Inc describes the new process 
execution environment and system 
software services provided with the first 
version ol the system soflware tor 
Macintosh on PowerPC computers. It 
contains information you need lo know to 
write applications and other software that 
can run on Ihe PowerPC PowerPC 
System Software shows 3n detail how to 
make your software compatible with Ihe 
new run-time environment provided on 
PowerPC-based Macintosh computers, It 
also provides a complete technical 
reference tor the Mixed Mode Manager, 
Ihe Cade Fragment Manager, and the 
Exception Manager. $2196 $22.45 

Inside Macintosh®: Sound by 

Apple Computer, Inc. describes the parts 
of the Macintosh system software that 
allow you to manage sounds. If contains 
inlormation that you need to know to write 
applications and other software that can 
record and play back sounds, compress 
and expand audio date, convert text to 
speech, and perform other similar 
Operations. $ 36.05 $24.25 

Inside Macintosh": Text by Apple 
Computer, Inc. describes how to perform 
text handling, from simple character 
display to multilanguage processing. The 


Foot, Script. Text Services, and Dictionary 
Managers are ail covered, in addition to 
QuickDraw Text, TextEdit, and International 
and Keyboard Resources mm $35.95 

Inside Macintosh*: Imaging by 

Apple Computer, Inc. covers QuickDraw 
and Color QuickDraw. The book includes 
general discussions of drawing and 
working with color. It describes The 
structures that hold images and image 
information, and I be routines that 
manipulate them. It also covers the 
Palette, Color, and Printing Managers, 
and the Color Picker. Color Matching, 
and Picture Utilities $ 36Ob $24,25 

Inside Macintosh": QuickDraw" 
GX Graphics try Apple Computer, Inc. 
shows readers how to create and 
manipulate the lundamental geometric 
shapes of QuickDraw GX to generate a 
vast range of graphic entities, It also 
demon sir ales how to work with bitmaps 
and pictures, and specialized QuickDraw 
GX graphic shapes $24.25 

Inside Macintosh 4 : QuickDraw" 
GX Objects by Apple Computer, Inc. 
introduces QuickDraw GX and Its object 
Structure, and shows program mars how 
lo manipulate objects in all types ol 
programs. $26 06 $24,25 

inside Macintosh*: QuickDraw" 
GX Environment and Utilities 

A companion to QuickDraw" GX Objects, 
this book contains programming 
information useful to any developer 
writing QuickDraw GX applications. It 
describes QuickDraw GX memory 
management, error handling, debugging, 
and mathematical functions, as well as 
conversion from QuickDraw to QuickDraw 
GX. mm $26.95 

Inside Macintosh 4 : QuickDraw" 
GX Library by Apple Computer, Inc is 
the powerful new graphics architecture loi 
the Macintosh Far more than just a 
revision ol QuickDraw, QuickDraw GX is a 
unified approach lo graphics and 
typography lha! gives programmers 
unprecedented flexibility and power in 
drawing and printing ali kinds of shapes, 
Images, and text. 

Inside Macintosh 4 : QuickDraw" 
GX Printing This hook is essential for 
any developer whose QuickDraw" GX 
application supports printing. II shnws 
how to support the new printing leatures 
of QuickDraw GX. including desktop 
printers and expandable printing dialog 
boxes. QuickDraw GX Printing also 
shows how lo use printing-related objects 
to add custom panels to printing dialog 
boxes and lo create custom page formats 
mm $24.25 

Inside Macintosh : QuickDraw" 
GX Printing Extensions and 
Drivers - Any developer who wants to 
create extensions lo the application 
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printing capabilities of QuickDraw" GX, or 
who needs to write a printing device 
driver that works with QuickDraw GX 
needs this book. QuickDraw GX Printing 
Extensions and Drivers describes how to 
create printing extensions and printer 
drivers, and provides a complete 
reference to the messages, functions, and 
resources (hat they use, Wi $ 26,95 

Inside Macintosh*: QuickDraw 
GX Programmer's Overview - This 
book provides an introduction lo 
QuickDraw* GX, providing an overview oi 
I he QuickDraw GX environment from a 
developer's perspective. It introduces the 
QuickDraw™ GX programming and runtime 
environments, the relationship between 
QuickDraw GX and the rest of the 
Macintosh* systems software and the 
relationship between QuickDraw GX and 
Macintosh applications t he key elements at 
QuickDraw GX programming, data 


structures, object types, and functions used 
most frequently hy QuickDraw GX 
developers are also covered. After a general 
introduction, ihis book provides readers with 
a series of practical examples demonstrating 
how to approach programming with 
QuickDraw GX. mm $ 22.45 

Inside Macintosh' : QuickDraw 
GX Typography - Ihis book is 
essential for any developer who uses 
QuickDraw' 11 GX to manipulate text, tt 
shows how to use QuickDraw GX objects 
to handle all kinds ol text from piarn, 
unstyled text to complex, mixed-direction 
and multi-language text with 
sophisticated stylistic and typographic 
variations. QuickDraw GX Typography 
shows how lo create and manipufate the 
three different types ol text shapes 
supported by QuickDraw GX including 
text shapes, glyph shapes, and layout 
shapes. J $ 26,95 


Inside Macintosh’ : QuickTime 

by Apple Computer. Inc. is tor anyone 
who wants to create applications that use 
QuickTime, the system software that 
allows the integration ot video, animation, 
and sounds into applications. This book 
describes all of the QuickTime Toolbox 
utilities. In addition, it provides the 
information you need to compress and 
decompress images and image 
sequences. $ 30.06 $ 26,95 

Inside Macintosh 0 : QuickTime 
Components by Apple Computer, 
Inc.covers how to use and develop 
QuickTime components such as image 
compressors, movie controllers, 
sequence grabbers, and video digitizers. 
mm $ 31.45 

Inside Macintosh : X-Ref by Apple 
Computer, Inc. is a fast access to all the 
information in Inside Macintosh. Inside 


Macintosh X Rot, Provides programmers 
with a quick and easy way to find the exact 
information they need in this definitive suite 
of books, (all 26 volumes). It is indexed by 
topic, volume, chapter, and accompanying 
page number. $ 17 . 95 . 

Inside the Macintosh Com¬ 
munications TooJBox hy Apple 
Computer This hook is the definitive 
reference to the Macintosh Commun¬ 
ications Toolbox, an integral part of the 
System 7 Macintosh Toolbox that enables 
developers to create communications 
applications or add communications 
features to other applications.This book 
describes all ol the routines that provide 
programmers with standard access to 
important communications services and in 
addition enables programmers lo extend 
the reach of lire Macintosh inio non-Apple 
environments. $2406 $ 22 . 45 , 
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BBEditS.1: Seepage 101 

CMaster 2.0 by Jersey Scientific 
installs into IHINK C 5 / 6 / 7 and 
Symantec C++ for Macintosh, and 
enhances the editor. Use its function popup 
to select a function and CMaster lakes you 
right to it. Other features include multiple 
clipboards and markers, a Function 
Prototypes and a GoBack Menu which can 
take you back to previous editing contexts. 
Almost ail features bindabfe to the 
keyboard, along over a hundred keyboard- 
only features like ' Add New Automatic 
Variable," Glossaries, AppleScript and 
loolServer support, Macros, and Externa! 
Tools you create foot $129.95 

QUED/M 2.7 by Nisus Software, is a 
programmer’s text editor which has defined 
the industry standard lor speed and 
efficiency. With integrated support for 
Symantec C/Cn, Melrowerks 
CodeWarrior 6. and MPW, QUED/M offers 
unrivaled usefulness for the Macintosh 
developer In addition to supporting all the 
major development environments on the 
Macintosh. QUED/M offers dozens ol 
powerful editing features, including 
unlimited undo and redo, UNIX style GREF 
searching, macro language, scripting, text 
folding, text sorting, file comparison and 
merging, toolbox lookup, ten 
editabfe/appendabte clipboards, tine 
numbering, markers, displaying text as 
ASCI! codes, vertical and horizontal screen 
splitting, plus much more. $149 

GodeManager™ Microsoft* /w 
Visual SourceSafe™ 4.0 compatible Ts? 
source code control system for the 
Macintosh* $399, Calf for more info. 

CodeWarrior 8 GD by 

Melrowerks comes in fwu versions 
- Bronze and Gold These CDs 


contain the CodeWarrior 7 
lllllll development environment 
|H jW l including C++, C and Pascal 
/ ¥\\ compilers; high-speed linkers; 
IhTIFMA native-mode interactive 
debuggers; and a powerful new application 
framework called PowerPlant for rapid 
Macintosh development in C++. Bronze 
generates 680x0 code. Gold generates both 
600x0 arid PowerPC code. Comes in two 
versions - Bronze and Gold. New to these 
versions is an integrated Class Browser 
Faster code, Better Code Generation for 
PowerPC Updated QpenDoc™ support. 
New Networking Classes in PowerPlant. 
New Editor Functions. Zero Overhead 
Exceptions for C+ 1 . Libraries for the new Be 
Operating System. CodeWarrior 8 Gold. 
With CodeWarrior’s plug in architecture, 
choose your target platform from within one 
Integrated Development Environment. Gold 
supports the following ptallorms: 
PowerPC™- Mac™QS, PowerTV™, Be™GS 
for BeBox™. 68K: Mac™QS. Magic Gap™ 
xB6: Windows 95™, Windows NT™. It 
includes C/C++ and Object Pascal 
CodeWarrior 8 Bronze. Macintosh 
programming solution dial generates code 
that runs native on 68K and runs emulated 
on PowerPC. Supports C/C++ and Object 
Pascal. Gold $399. includes a 1 year 
Mac Tech subscription Bronze $149. 
Includes a 6-month subscription. 


SYMANTEC. 


Symantec C++ See page 101 

THINK Pascal v. 4.0 by Symantec 
Corporation. Professionals and students 
will welcome this version of THINK Pascal. 
It is fully integrated for rapid turnaround 
lime and lets, you lake advantage ol System 
7 capabilities. Features include support lor 


large projects, enhanced THINK Class 
I ibrary, System 7 compatibility, superior 
code generation, and smart linking. Product 
Contents: Four Macintosh disks, a 562- 
paye user manual, and a 498-page object- 
oriented programming manual. $169 

LS Object Pascal CD includes the 
world's first Object Pascal compiler for 
Power Macintosh. 100% compatible with 
Apple's MPW Pascal, LS Object Pascal 
combines the best of Apple’s native 
development toots with innovative new 
technology developed at Language 
Systems. Compiler options specify 68K or 
native PowerPC code generation. included 
on the CD are: LS Object Pascal compiler. 
Universal Pascal Toolbox interfaces, fully 
loaded MPW 3.3.1, 68K and PowerPC 
source debuggers, PowerPC assembler, 
online documentation, Macintosh Tech 
Notes, and a special version of AppMakei 
by Bowers Development that generates 
native Pascal source code. The beta 
release includes upgrades to vl 0 when it 
becomes available $399 

LPA MacProlog comprises a 
Edinburgh syntax Prolog compiler system 
set in an attractive multi-window 
development environment with an 
Integrated program editor, graphical call 
graph facilities and an interactive source- 
level debugger. LPA MacProlog features 
high-level access to the Macintosh 
ToolBox for using graphics, dialogs, 
windows, icons, resources in a simple and 
versatile way LPA MacProlog also Includes 
interfaces to C and Pascal code resources. 
The MacProlog Run-time Generator 
enables tlie production of double-clickable 
distributable applica tions The compact 
run time system supports first argument 
indexing, lad-recurs ion and last-call 
optimization. Optional add-ons Lools 
include Ilex, Profogn, MacDBI for Oracle 


and the MacProlog Dialog Editor, 
Programmer Edition $745, Developer 
Edition (which includes the run-time 
generator and distribution license) $1500 

SmailtalkAgents® (STA) is a 
sophisticated 
application 
development 
environment 
featuring a new generation of the Smalltalk 
language, QKS Smalltalk™. Productivity is 
no longer measured in lines of code, but 
in project no mp tell on time. STA allows 
"live" direct manipulation of your objects. 
The development process is dynamic, 
interactive and iterative. Just like C/C++ 
and Assembly, STA provides easy and lull 
access to the features ot the MaeQS™ and 
Mac Toolbox. You can link your nnn- 
SmalUalk code resources using our 
External Code Linking Toolkit™ (ECLT). 
You can also call back into STA from 
foreign functions written in C/C++. Pascal, 
FORTRAN, and Assembly STA s 
automatic garbage collection and object- 
based typiny will tree you I ram tedious 
memory management and bookkeeping 
chores A sophisticated database for 
source code management provides an 
almost infinite variety of ways to cross- 
reference, access, view, and manipulate 
yuur code and objects, STA includes an 
Application Delivery Toolkit™ (ADT) that 
allows you to create royalty-free, stand¬ 
alone, double‘Clickable applications In 
just a matter ot mi rail es. The foundation of 
the QKS Producl Family, the Agents 
Object System (AO/S), is an underlying 
lack Iramework, housing components and 
services Ihat save you years of work. Any 
component built in AU/S will function as 
an 0-penDoc component or container and 
components from non-AQ/S sources can 
be seamlessly integrated into the AQ/S 
system SmalltalkAgents List Price: $695 
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ICOMIX PowerTools by /*. 

ICONIX has been a teadmg^p> 
supplier of CAST tools, since 1984. One 
of the lirst Object-Oriented CASE tool 
developers, ICONIX is known throughout 
the industry for producing affordable, 
high-quality tools and stale ct the-art 
training. Our lino of Object-Oriented 
Analysts and Design tools. ICONIX 
PowerTools, is an integrated set of ID 
CASE tools supporting the major phases 
ol the system development life cycle and 
automating analysis, design, coding, and 
the management of complex systems. 
ICONIX is unique because we are the first 
to bundle CASE tools. CD-ROM training, 
and on-site training and consulting. Each 
individual modulo is $1,495. PowerPack 
Bundles Choose any 6, 8 or ID distinct 
modules of ynur choice to customize your 
own ICONIX PowerTuols toolset. Our 
professional sales staff wilt gladly assist 
you in choosing the right tools for your 
project's needs PowerPack/6 $5,995 
PawerPack/8: $6,995 PowerPack/10; 
$7,995. (Full Product Line) Call lor 
pricing on Upgrade Service & Training 
and Consulting. 

Voodoo is a version control tool far the 

voo i>o o s ’ m P ,e 2 ncJ cl m mana £) e_ 
™ men! of projects in which 

lites are created in 
numerous versions 
(variants and revisions). 
Voodoo allows both variant and revision 
control, and it manages not onEy variants 
and revisions of sing fa tiles, but of a whole 
software project (mufti files, multi users, 
multi variants, access rights, ..). TTie tool 
□tiers a neat graphical user interface and is 
not only suitable for mere source code 
control but can handle all 
HOT different kinds ol fifes with 
ITEM! amazing compression rates: 
typical size of delta between 
arbitrary files 5% (in words live per cent) 
fill no matter whether the files are plain text 
or any other documents - e.g,, MSWord, 
4D, Canvas, FileMaker ... Please note 
special prices for multiple copies 1 single 
license $190; 2 pack $300, 5 pack $665. 
10 pack $1140; 20 pack $2000 Addl 
pricing available on request. 


PROFILERS/ 

DEBUGGERS 


LJ Profiler by Lars Jordebo 
Datakuusull supports profiling ot Cm 
68K and PowerPC applications compiled 
with CodeWarrior 6, CFront or Symantec 
C++. Based on active profiling, Le. 
profiling code called at function enter and 
exit, the browser application Ids you 


follow caff chain timings in hierarchical 
vrews or separate windows. Collect, 
organize, compare and save profiling data 
from different versions of your application 
into a project. Scriptable and recordable 
with full access to mos! infernal data 
structures. Optional remote profiling and 
fracking of segment and stack usage. Full 
source code to what you link into your 
application. $295. 

last Resort Programmer's 
Edition records every keystroke, 
command key and mouse event (in local 
coordinates) to a file on your hard disk. 
This is especially useful for program 
testing & debugging, and lor technical 
support and help desks. It something 
goes wrong (because ot a power failure, 
system crash, lorgelling to save or 
deleting lines) and you lose a word, 
phrase, or document you can look in Ihe 
La si Resort keystroke file and recover 
what you typed, Lasl Resort is also useful 
lor technical support personnel, when 
lhey have to ask "What was the last thing 
you did before...?" $74.95 

QC* by Onyx Technology. See page 69 
The Memory Mine by Adianla is a 
stand alone debugging tool for Macintosh 
and nafive PowerPC. Programmers can 
monitor heaps, identify problems such as 
memory leaks, anti stress test appti- 
cations. Active status of memory in a 
heap is sampled on the My; allocation in 
non-relocatable (Plr), relocatable (Han¬ 
dle) and free space is shown, as are heap 
corruption, fragmentation, and more.., 
Allocate, Purge, Compact, and Zap 
memory let users stress test all or part of 
a program. Source code is not needed lu 
view heaps, IE works on Macintoshes with 
68020 or later arid System 7.0 or later. 
$99 

Spyer by inCider is a simple operated 
tool lhal records ail actions (including 
mouse movement) you perform on a 
Macintosh computer and then 
replays them a! your preferred speed. 
The recorded data can he saved in liles 
tor future use. Spyer works as a 
background process with any Macintosh 
application and is triggered by user 
defined Hoi Keys. Spyer enables the 
''Continuous Redo" utility and is 
especially useful for software testing and 
demonstration, $39 


INSTALLER TOOLS 


In staffer Pack" by Step up Suit ware is 
a package ol several Installer "atoms" that 
lei developers incorporate graphics, 
sounds, file compression and custom 
folder icons into installation scripts 
Compression formats supported are 
Compact l J ro & Diamond. Each atein also 
available separately. Compression 



requires additional licensing. $219 

ScripTGen Pro" by SEcpUp Software 
is an installer script generator which 
requires no programming or knowledge 
of Rez. Supports SlepUp's InstallerPack, 
SLulIll compression, custom packages, 
splash screens, network installs, Rez code 
output, importing resources, and 
AppleEventlinkw/MPW: $169 


fully portable cross all supported 
platforms, Third-party vendors supporting 
dtF will be able in offer a variety of 
advanced features and benefits to their 
customers royalty free. Tools are included 
foi importing, exporting, creating and 
managing databases and users 
Supported development environments 
include. Symantec, MPW, Metrowerks 
and more. Mac/SDK $695 


LIBRARIES/ 

FRAMEWORKS/ 

DATABASES 


OOFILE See page 100 
PowerTap 1 * See page 100 

3D Game Machine vl.2 by 

Virtually Unlimited is a C library lor 
creating lightning-last 3D arcade games 
and interactive multimedia applications. 
3DGM has a simple easy-lo-use interface 
and features very last rendering (15 
frames per second on a 14" monitor 
completely texture-mapped, wilh a 
PowerMac G1G0/GG), lull "virtual" 3D 
worlds with six degrees ol freedom, free- 
form texture mapping, shading, material 
and light properties, convex/cave 
polygons with unlimited vertices, 
unlimited light sources, dynamic hidden 
surface removal, special graphic modes 
for last lull-screen animal ion, collision 
deletion, explosion simulation. 3D data 
importing. Runs on all Macs! Works with 
CodeWarrior. $299 + license. 

Animation Class Library version 

2.0 (ACL2.Q) is an advanced objecl- 
oriented multimedia framework, allowing 
fast development of high-quality 
interactive applications. Main features n! 
ACL2 G are: Powerful animation engine 
which supports structured sprites, 
collision detection a! pixel precision, 
sprites sorting, powerful blitter and vector 
objects Scrolling of background picture 
in circular buffer and Itte-mapsc rolling* 
Application framework for building 
standard and 3D controls, panes,menus, 
lull screen displays, windows, etc. 
Quicklime and multi-channel sound 
support >800 functions and >100'0flfl 
fines. Complete C++ source code fur 
CodeWarrior and Symantec C++, 
examples, documentation and technical 
support. $250 

dtF Is a true relational database system 
for Apple Macintosh computers. dtF 
provides a powerful choice far developers 
who wanl lo create database centered 
applications with no performance trade¬ 
offs dtF features SO!, full transaction 
control, error recovery, single user, client 
server architecture and multi-platform 
support Including DOS, Windows. OS/2 
and UNIX. The C/C 1 i API is identical and 


MacWireFrame by 

Amplified Intelligence 
Create your own virtual 
reality application with 
MacWireFrame, a virtual reality 
application trame work. Includes a 
complete library ot object oriented 
graphics routines, its own easy to 
understand application trame work 
(similar to MacApp or I CL but a lot easier 
lo understand), plus an example 
application program lhat lets you start 
solid modeling right away Comes 
complete with fully documented source 
code. All new purchases will be 
guaranteed a $49.99 upgrade to the seen 
to be released, scriplable, MacWireFrame 
5.0, Due to the overwhelming response 
the special price offer has been extended 
for a little white longer. Special Offer: 
$209.00 $ 75 ! M! 


PictureGDEF 

t.3 by Paradigm 
Software is a 
professionaMeve! CDEF for creating 
custom graphical buttons (8 64 pixels). 
PictureCDFF is used in products by 
Adobe, PruVue. SIF lech- 
HOT nologies and others IE is 
ITEM! multi-monitor and bil-depth 
sensitive. The button graphic 
(cion, ResFdit) can he changed at runtime 
and even animated with a call-back 
routine. Create distinct buttons in seven 
variations; MultiState. PushRutton, 
FtexrButton, TogglcButton. ChkButton. 
PushPictButton and TogqtePictButtnn. 
Position the optional button title at left, 
bottom or right, or follow II le system lex I 
direction for international support. 
Manual, sample code and MacApp 3.0 
support included. Full source code 
$95.00 Object node: $45.00. 

Q3S/3dPane/SmartPane source 
code bundle by Vivister Consulting. Q3S: 
source code bundle from VivrStar 
Consulting, Full featured 3d graphics. 
Points; lines, polygons; polyhedra; 
Gnuraud shading; z-buiteriug; culling; 
depth cueing; parallel, perspective, and 
stereoscopic projections; performance 
enhancing ’QnlyQD" and 'Wireframe" 
modes; full clipping; pipeline access; 
animation and model interaction support, 
and a “triad mouse 0 lo map 2d mouse 
movement to 3d. 3dPane provides 
integration with the TCL and provides a 
view orientation controller. Smart Pane 
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provides TCL ol (screen image buttering, 
flicker Iree animal ion. and QuickTime 
movie recording SmartPane fund ions in 
3d or 2d scenarios All work with C++ 
compilers or ThinkC 6 and compile ro 
PowerPC or 68K target machines. $192 

SpellsweJI 7 1.0.4 is an award* 
winning, comprehensive, practical spelling 
checker that works in batch mode or wilhin 
applicalions that incorporate the Apple 
Events Word Services protocol {e g.. 
Eudnra, WordPerfect Communicate!, and 
Pair Witness). Speltswell l checks lor 
spelling errors as well as common typos 
tike capitalization errors, spaces before 
pond nation, double double word errors, 
abbreviation errors, mixed case errors, 
extra spaces between words, a/an belore 
voweVconsonani, elc.. MacTech orders 
Include developer kit with Wrileswell Jr., a 
sample Apple Events Word Services word- 
proecssor and ils source code. $74.95 


StoneTable Extra: Additional 
functions lor StoncTabte Drag setecled 
cells within table or to oilier tables; 
Optionally add rows as part ol drag; popup 
menus or check boxes in cells; variable 
width grid lines; move/drag/resize Sable in 
window; clipboard operations on multiple 
cells Requires StoncTabte (all prices per 
developer) $50 firs! compiler, additional 
compilers $25. 

StoneTable: A library replacing all 
functions found in list manager plus: 
variable size columns/rows; diKeren! tom 
Size, style, tnrecolor, backcolor per cell, 
sort, resize, move. copy, hide 
cnlutnns/rows; edit cefls/lilles In place: 
lilies for columns7rows; multiple lines per 
cell; grid line pattcm/color; greater than 
32k data per (able, up to 3?k taxi per cell, 
support for balloon help and binary cell 
data Versions lor Ihink C, Think Pascal, 
MPW C. MPW Pascal, CodeWamar 6 C 


tall prices per developer) $150 lirsl 
compiler, additional compilers $50 

StoneTable and StoneTable- 
Extra for PowerPC: Same function 
a lily as 68K libraries. Versions tor MPW 
C and CtxteWanior 6 C Musi have GBK 
libraries, (all prices per developer) 
SluneTahfe $1GU. StoneTabieExIra $25 

B-Tree HELPER' 2.2 in an yv. 

inexpensive database engine tor 
Macintosh programmers In C source 
code B-Tree HELPER gets space in a file 
in contiguous fixed Jengih blocks It 
expands She file as necessary and 
contracts tries when pnssihle B-Jm 
HFI PFH inserts and rieleles keys in one 
or more B-trees It liritls keys equal to, 
less than, or greater Ilian a given value in 
a few hundredths of a second, h finds 
lists ol records whose keys arc equal lo, 
less than, or greater lhan a given value or 


are In a range of values $150 

AppMaker makes II taster and 
easier iodeveinp I he user interface 
lor a Macintosh application Just point 
and click lo design your application, then 
AppMaker creates resources and generates 
excellent source code. AppMaker supports 
most development environments including 
Metrowerks. Symantec, or MW; C, C++, 
nr Pascal; procedural ur object-oriented, 
using Power Plan!, TCL. oi MaeApp The 
generated code uses the Universal Headers 
to provide PowerMac compalibilily 
Beginners use AppMaker lo learn nbjEcl- 
oriented and Macintosh Toolbox 
programming techniques Experts use it to 
increase productivity It saves so much 
time its like having your own assistant 
programmer working for you Includes 
one year subscription nn CD. $299 


SCRIPTIAIG/SYSTEM ADMINISTRATION 


SCRIPTING/ 

SYSTEM 

ADMINISTRATION 


ScriptWizard See page 102 

FaceSpan "v2: See page 101 

DataScnpt DataScnpt is probably he 
quickest, easiest and most cnst^ltedive 
way to make your integrated AppleScript 
solutions database aware-today 
Quickest It takes just six lines of 
AppleScript to make new or existing 
scripted solutions database aware, and 
fetch data from RDBM's such as Oracle, 
Sybase. DB2, or Intermix Easiest: 
DataScripVs scripting terminology is easy 
to learn, easy to use. and easy to 
remember "Inside DataScnpt" contains 
lots of easy 10 follow scripts lo muse !n 
your own solution Cost Effective: 
Because OataScripl is so easy lu learn, 
and use you'll become productive very 
quickly, and once you're ready to ship, 
you'll find our licensing schemes very 
attractive. $249,00 

Scripter : Bee page 101 

Climate by Orchard Software is a 
command line interface that lets you 
communicate with your Macintosh using 
English commands to create, delete, 
rename, and move fifes and folders. II can 
start applications, format disks, restart 
your computer, etc. Climate supplements 
the Finder It includes a BASIC interpreter 
that lets you script your Macintosh 
without AppleScrlpI The Interpreter 
includes advanced programming 
constructs: repeal loops, I f/l hen/else 


conditionals, subroutine calls, etc 
CLlmate implements wildcard characters, 
enabling you to work on groups nt tiles. 
Use Ct I mate instead ol MPW to manage 
your projects. CLlmate is an application 
occupying 70K disk space 11 comes 
bundled with sample programs and full 
documentation $59.95 

Cron Manager by Orchard Sultware 
implements the UNIX Cron facility, II can 
open any Macintosh life on a given date 
and time By creating an alias, renaming it 
to the date and time to open, and moving 
it into the special Cron Fvents Folder, 
Cron Manager will open it. Crop Manager 
is a control panel that creates Ihe special 
Cron Events Folder inside your System 
Folder II is completely transparent to the 
user. It works like the Startup Items folder, 
only smarter II works with any Macintosh 
file: il you can double-click lu star! it. 
Cron Manager can open il. $2G 95 Cron 
Manager bundled with CLlmate, $59,95 

Rosaline™ Rosannc is a collection nt 
tit! lilies which offer the user comp tele 
control over raw data. Users can sort files, 
extract selected records, summarize 
Irequency counts, create sample files, 
perform matching on multiple files, and 
reformat data to new spedlicafions, all on 
Ihe desktop, and even on files ol a million 
records or more. The Rosaline Utilities 
also support AppleScript™, enabling the 
user lo link several actions together to 
complete an entire process, The Rosanne 
Utilities are recordable; users may 
perform a series ot actions, and using an 
AppleScript editor such as Scripter™, see 
their aclions translated directly into 
AppleScript commands. All of the utilities 
support multi-tasking and background 
processing The Rosanna Utililies will 


assist you in picking your sped I otto ns. 
determining record length, creating 
out pul files and managing the storage of 
date Rosanne Utilities: Copy 
duplicates an input file. Formal 
creates an altered version nf an input life, 
containing either subsets of the fields on 
ihe input tile, or new lields. Select - 
creates a subset of the records on an 
input tile based on some selection 
criteria The Recode oplion allows the 
user to group data, or correct coding 
entries Sort orders an input life by a 
particular held or set ol fields Match - 
joins together two input Ides based on 
common values occurring in 
corresponding fields or sols ot fields. 
Aggregate creates an output tile with 
summary levels. $595 

ScnptBase™ The Scripting 
Database is a database for storing 
persistent objects to be made available for 
access to AppleScript. Apple's systern- 
Icvol user scripting language lor 
controlling applications on Macintosh"' 
computers. Once installed, the database 
becomes part of ihe AppleScript system, 
adding a host of commands to the basic 
AppleScript vocabulary. Retrieving the 
objects is simple using AppleScript's 
nalural-language syntax and structure 
Objects stored and retrieved in Script Base 


can be accessible any lime from any 
script on the user s computer These 
objects can be ol any type. Including 
numbers, character strings, lists, records, 
scripts, and references lo disks, files, 
Iuliters, as well as abstract raw data, to 
name just a lew ScriptBasc ran be used 
to maintain system-wide settings, such as 
sets of preferences, paths lo frequently- 
used lites or folders. Complex 
installations can be made easier by 
organizing date and scripts within Ihe 
database's structure $79 

Script Debugger tty Ufa 

Night Software ltd. is a HOT 
powerful and flexible HEM! 
AppleScript authoring toot 
Scrlpl Debugger makes it simple for novice 
and experienced script writers to gel the 
most from AppleScript The program's 
advanced debugging environment offers 
single-step scripl execution with 
breakpoints The Script Debugger 
dictionary browser features a graphical 
view of objects provided by snripteble 
applications With the program, you also 
receive the Late Night Sufiware Scripting 
Additions, a collection ot more than 70 new 
AppleScript commands, and Scheduler, a 
utility that allows you lo launch scripts al 
pre-delerm inert limes $129 


SOFTWARE FOR SALE? 

List your product in MacTech Magazine's Mail Order Store. 
For more information, call HO 94-9797. 
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TCP/IP Scripting 
HOT Addition" is Itie latest 
ITEM] version ot an award-winning 
AppleScript scrip!mg addition 
(first place in the 1994 "Best Hack" category 
in the Everyday AppleScript" Programming 
Compelition) This scripting addition (or 
osax) allows you to write scripts using 


MacTCP' commands in AppleScript' 
Potential uses of this include sending e- 
mail or tiles through a script, checking if 
users are logged on (via Finger), 
automating FTP, Gopher, NelNews, Telnet* 
and LPR. verifying links in HTML 
documents, and quickly writing many other 
TCP/IP client-server programs Sample 


scripts are included already implementing 
many of these functions. When combined 
with FaccSpan, the potential for rapid 
implementation of Internet cl rent-server 
applications is enormous The TCP/IP 
Scripting Addition works wilh AppleScript 
1.0 or later and MacTCP 2,04 or later, II is 
compatible with Open Transport™ The 


1 CP/IP Scripting Addition can he used from 
Script Editor. HyperCard 2.2, Mac PEP L, 
FaceSpan and other Open Scripting 
Architecture applications. See “http:// 
www mangotme conybiz/mango/index him I 
"tor more details. $49 


MACTECH EXCLUSIVES/MISCELLANEOUS 


MacTech Magazine is your exclusive 
source for these specific products 
including available back issues of 
SFA 's magazine, source code disks 
and assorted cd's. Call for more info 
and pricing: 

Ad Lib 2.0 The premier MacApp 3.0 
compatible ViewEdit replacement, A 
powerlul user-interface editing tool to 
build views for MacApp 3.0 and 31 Ad 
Lib allows subclassing of all ol MacApp's 
view classes including adonters, 
behaviors, and drawing environments. 
String and text style resources are 
managed automatically Alternate display 
methods, such as a view hierarchy 
window, allow easy examination of 
complex view structures Ad Lib includes 
source code tor MacApp extensions that 
are supported by the editor - buttons can 
be activated by keystrokes, behaviors can 
be attached to the application object, and 
genera! purpose behaviors can be 
conligured to perform a number of useful 
functions Run mode allows the user to 
try out the views as they will work in an 
application. Templates can be created to 
add additional data fields to view classes 
Editing palettes provide fast and easy 
editing ol common objects and attributes. 
Works with ACI's Objecl Master (version 
2.0 and later) to navigate a project’s user 
interface source code. $195 

Frameworks Magazine: $8/hack 
issue, subject to availability 

FrameWorks Source Code Disk: 

$10 per back Issue, subject to availability 

Five Years of Objects CD-ROM: 

FrameWurks archives and source code 
Irom April 1991 to January 1993, plus 
selected object-oriented publicly available 
software and demos $95 

MADACON 93 CD-ROM: The 

highlights ol MADACON '93, including 
Mike Petal on Pink, Bedrock. MacApp, 
OOOLs, and more Slides, articles, 
demos, audio, and QuickTime $95 

MAScript 1.2 adds support tor 
AppteScripl to your MacApp 3.0.1 and 3.1 
based applications Make your application 
scfipfabte and recordable by building on a 
tried and tested Ira me work for object 
model support MAScript dispatches 
Apple events to the appropriate objects, 
creates object specifiers, and makes 


Mail Order Store 


framework objects like windows and 
documents scrrptable and recordable. 
Sample application shows you how to 
begin adding support for scripting and 
recording. MAScript includes complete 
source code. Install MAScript by 
modifying one MacApp source file, then 
adding another to your project Future 
versions ol MacApp will incorporate 
MAScript. so MAScript support you add 
now will work in the future, $199 

The Mjolner BETA System is a 

soltware development environment 
supporting object-oriented programming 
in the BETA programming language. 
BETA is uniquely expressive and 
orthogonal. BETA unifies just about every 
abstraction mechanism - including class, 
procedure, function, coroutine, process 
and exception - into the ultimate 
abstraction mechanism: the pattern. 
BETA includes: general block structure, 
strong typing, whole/part objects The 
compiler: binary code generation* 
automatic garbage collection, separate 
compilation, interface to C. Pascal, and 
assembler. The system: persistent 
objects, basic libraries with containers 
classes, platform-independent GDI 
application frameworks on Unix, Mac and 
Windows NT. mefa prog ramming system 
The tools available on Unix: the hyper 
structure editor supporting syntax 
directed editing, browsing, etc., and the 
source code debugger are currently being 
ported to the Macintosh system The 
Mainer BtlA System tor Macintosh 
requires MPW (basic set) 3.2 or Idler 
Package corUaining compiler, basic 
libraries, persistent store, GUI framework* 
and comprehensive documentation 
(Other packages am also available) $295 

More Savvy includes ail Savvy features 
plus Apple Event support for all sub¬ 
classes ol TEventHandlef with extensive 
view support Apple Event support for text 
includes text attributes and sub-range 
specification. Recordabrllfy supports 
additional actions, and coercion includes 
additional types. Additional client and 
server Apple Events $450 

Savvy 1*1 OSA support includes 
attachahrtity, reeordabitify, 
scriplability, coercion* in 
addition to scrip! execution, 
idling and i/o Apple Event support 
includes complex object specifiers, 
synchro no us/a synchro nous Apple Even! 


handling, and Apple Event transactions for 
clients and servers The Core Suite of 
Apple Event objects is supported 
including the application, documents, 
windows, and files. Documentation 
includes technology overview, cookbook, 
and sample code $250 Savvy now 
supports MPW 3.1,3,11 and continues to 
support 3.01, as well as supporting 
Metroworks CodeWar nor This month 
only, special offer-All Savvy versions 
include tree copy of Savvy QuickTime! 

Savvy QuickTime Requires Savvy, 
More Savvy, or Super Savvy Includes 
QuickTime. Apple Event, and view 
template support Movies come oul of the 
box teady to play, edit, and react to Apple 
Events. They can be included in any view 
structure, including templates, and are 
displayed in the scrap view. Movie 
controls include volume, play rate, 
looping mode, display style, and other 
characteristics. $250 

Super Savvy includes all More Savvy 
features plus compile, edil. and record 
scripts using built in script editor View 
template editors, like Ad Lib. can attach 
scripts to view objects and modified 
scripts are saved with the document 
Script action behavior allow quick access 
for executing and editing scripts attached 
to views, text to object specifier coercion 
plus more, $700 


MISCELLANEOUS 


BASIC for the Newton is 

BSpffl BASIC lor the Newton 1 From 
|jg| NS BASIC Corp-umlien, it is a 
f u ||y interactive implementation 
of the BASIC programming language. It 
runs entirely on the Newton no hosl is 
required. It Includes a luli set of functions 
and data types, hand-written inpul, 
windows, buttons and extensions to lake 
advantage of the Newton environment 
Applications can create files or access the 
built-in soups Applications can also 
access the serial port for input and 
output. Work direclly on the Newton, or 
through a connected Mac/PC and 
keyboard NS BASIC includes a 240 page 
pocket sized manual. Runs on all Newton 
l x and 2.0 units $99 

Inside CodeWarrior 7 Inside 
PowerPlant; See page 101 


Mac' 


Guide Composer gives anyone the 
ability to create powerful Apple Guide help 
systems for any new or existing Macintosh 
application. Great for commercial 
developers, shareware developers* in 
jKiuse developers, and consuHants, Guide 
Composer provides a WYSIWYG 
development environment: Guide content 
is developed in Guide windows Design 
topics, phrases, and panels in the same 
format as the user will use them, Features 
are WYSIWYG interface* Topics, phrases, 
and hierarchical phrases. Coach marks. 
Fully-Integrated with Apples Guide Maker 
(distributed with Guide Composer), 
compiles scripts automatically. PlCTs in 
Panels. Generated Guide scripts are 
modifiable. Compiled flies are 100% 
Apple Guide-compatible ami royalty-free. 
Easy-to-use. $99 

MachTen UNIX for Macintosh and Power 
Macintosh MachTen is a Berkeley UNIX fhaf 
runs an the Classic to the Power Mac, 
including PowerBooks and Duos! So, in 
addition to all of the Macintosh applications, 
you get a Mach-based UNIX wilh pre¬ 
emptive multi-tasking MachTen extends the 
Macintosh operating system with UNIX 
networking and soltware development tools. 
The Macmloslt/UNIX integration is so strong 
that you can even use Macintosh programs 
and utilities on UNIX data, and UNIX 
programs and utilities on Macintosh files. 
Full internet protocol support ensures fast, 
easy client and server NFS, e-mail, and file 
transfer between the Macintosh and all TCP- 
based entities on your network BuiiHn 
internet services Include domain name 
service, POP mail service, internet routing, 
BLIP ft PPP, and Web service Full X11R5 
support wilh Motif for developing X 
applications and a high perlormance X 
server (or using your Mac as an X terminal. 
MachTen Power UNIX $595. Personal 
MachTen (for 68K Macs) $495 
Professional MachTen (lor 68K Macs) $695 
MachTen X Window Software $350. 

Roaster ORI" See page 100 


Geekware ny Metrowerks 
Mnusepad SB 95 

Geekware Hawaiian Classic.$7.95 

Blood, Sweat ft Code Black 
Long Sleeve Shirt . S14 95 

Cross Platform White 
Short Sleeve Shirt $1495 
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TIPS & 
TIDBITS 


By Sieve Sisak, Contributing Fdilor 




TIP OF THE MONTH 


Here is a handy (unction for making sure 
that an unddciable “file from hell* doesn't 
get in the way during program execution, just move it to 
the Trash. This only works when the file is on the same- 
volume as the Trash, however* 

Greg Poole 


File FSpTn.vhFik-.il 


FSfTnuhFBc h 
htrtnry 

riitidilitJ m/ix/xx 
created 

(iitg 

Vital Inc 

enuil pvgVvlialimagcs com 


wIhi arc you* wtm did yon dtp 

Kir^pook 


tpr&gm once 

lifdef ^.cpl u*pJ us 

extern “C* l 
femiif 

extern OSErr FSpTrashFilel FSSpecPtr File ); 

lifdef cplusplus 

( 


lemiif 


l : tk FSpTndiHkx 


Move a fifc Ui (be irjsb il il ts not possible ui tickle it 
(Ian only move Ilk to the trash if il is un die -sunt volume 
a\ (he file in tic deleted 


1 i IM I f I i . H H H l MM I I 


#l(itlud« (Folders.h> 
tfinclude *FSpTr»xhFile*h w 

OSErr FSpTrxRhFll#i FSSpecftr tfaeFile ) 


l 


GEKrr tboErr “ noRrrs 

short vftofNun; 

Ions dirID; 

FSSpec spec; 

FSSpecPtr thaTrixh “ &spee; 

ft don't jso my fnnher if there im t i frit to d cil with or d the 
H file WJv ik klrtS vih ix^vliith 

// 

theCtr * FSpDeletel theFile ); 
if ( theErt — fnlErr || thelrt “ noErr ) 
return noErr; 


U ifwc jitn ihtv far wc tutl a jjmbkm tkkiing the file. 

// don't worry, rebut jnd juvi Lndt it 

the&rr - Findpoideri kOnSysteiiMsk, kTrashFolderTypo, 

k&ontCreatoFolder, ivlteffluin, fcdirtB ): 

if ( rheRrr — noErr ) 

rheF*ri * FSHiikoFSSpm* { yRefNu*, dir TP f *\p*. rheTrsfih }; 
it t tlioErr — nuErt } 

It { theFUe >vRi*flimu !■ theTnsh ^vRetNum ) 
theErr * dlffVolErr: 

if ( theErr “ noErr } 

fbrF.rr • CutMove( fh©FIk >vRrfMim. fheFlie >parttl» 
ihoFilr ihcTrash >pattl>* theTraah >iiiisc )s 

return theErr; 

l //cnirsplmbtit 

// tkfmc TOTJTUSH FIJI* inf j >undjk»nc 

Id©fine TEST_TRASH_FtLE 

lit tietinedi rmjnumj'Lu ) 

// local function prototype* 

static void ItiitTh*iHxc{ void h 
rratie Bool can GerAFUef FSSpecPtr file ); 

sialic void liiiiThcNucf void 1 

I 


Continued on page 95 


..*♦#* t*s«M eiijjia 

fit enBetterBusError 

on your machine! Chi the other hand we might just 
pay you 525 for each Up uv use or $50 for Tip of the 
Month. You can take your award in goods, 
subscription or f SS Make sure any code compiles, 
and send tips (and where to maUyaur mnnings) to 
our new Tips e mail address tit tips%machxh cum. 

See [hi ge two for our ath&ckkhisseL 



i i iimi Min i 


end us your ti/ts or ttv ll install 


112 


Tit’s & Timms 


Mac Tferi i M ac;azink • Janhahv 1996 




























He Should 
Have Used 
JAM? 


Windows 9 b, 
Windows NT, 
Windows 


Building Client/Server Applications Doesn’t Have to be Painful. 

Get JAM® 7 - a Smashing New Version! 

Mother you ate a business analyst or a top seeded developer - j 1 1 7 makes it easy to develop and 
deploy industrial-stncngth appta toons. I"he ncvwst release of JYACCs industry-leading second 
generation dient/server tool gives you the features and Ability you need to see complex projects 
successfully through from start to finish. . JAM allows you to build dierrt/server abdications on The 
Macintosh and deploy them across platfor ms including OS/2 Warp Mottfi Windows 3,1* Windcws 9b* 
VAX/VMS* and virtually every Implementation of UNIX, Arrd unlike the competition’s runtime-only Mac 
ports, JAM for the Macintosh provides a full application devebpment environment with true Mac 
look and feel. So don't bear the pain of inadequate tods — get JAM and be a winner! 

JAM gets your Macintosh applications up and running with: 

./ GiPtt nnA */ artA N^ihivr SnrJrvirr, fnr Orar.fe 



/ Native Mode on both and 
Tower Macintosh 

/ True Mac Look and Feel 

/ Portability to Windows 96, Motif* 
OS/2 War p, and Character-mode 

/ depository Driven Development 


/ Access and Native Support for Oracle* 
Sybase* ODBC and more, 

y Visual Object-based Development Environment 

/ Database Screen Wizard with Full 
Transaction Control 

/ Automatic SQL Generation 


Call 1-000-458-3313 

or E-maih macjam^jyacc.com for a free dtfmonst ration kit. For international inquiries 
call: 1 " 212 - 207*7722 or FAX 1 212 60 &- 67 B 3 , Visit our Web site at http: //www.jya cc.com. 
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metrowerks 


' . r " 1994 SOFTWARE 

PROfiUCT 
OF THE YEAR 


To order contact Metrowerks: 

voice: (512) 305*0400 fax: (5l2) 305*0440 e-maii: sales(Sjm'etcwverte;cotn 
^ World Wide Wel^Jrttp://wvw ' ;; ^, r< 

Mfitrowe^i, the Metrowerk* iofa Po^erPtint andCowWjiJjW ®£t«rdd trEpi^i ofrMt-T^rS 
AIL other companies and products are tradeijrarks of thefr resffectiv* holding and are *ecogni»d. 
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